Get started

From zero to a first query in two commands — no schema, no indexes, no DBA. Build it, run it, talk to it.

Build

Two static binaries from the repo — server and CLI.

$ cargo build -p xyzdb-server -p xyzdb-cli --release

Run the engine

One process, one port, one volume. The defaults are production-safe.

$ cargo run -p xyzdb-server --release -- --path ./data --port 2505

Docker

Or build the image locally from the repo Dockerfile (distroless runtime, server only).

$ docker run -p 2505:2505 -v $PWD/data:/data \
    <local-image> --path /data/xyzdb

Your first query

Connect with the CLI and write — no schema step, no index to declare.

$ cargo run -p xyzdb-cli -- --port 2505
xyzdb> PUT {*rfc: "ACME-001", _type: "Credit", monto: 50000} IN "creditos"
xyzdb> FIND "creditos" WHERE rfc = "ACME-001"

That is the whole loop. Next: the data model and the language.