Run Orbita locally.

You need Rust and the Orbita repository. The development command starts one process as both leader and worker on 127.0.0.1:7100, with state under .orbita/dev.

Start the node from source

git clone https://github.com/orbita-rocks/orbita.git
cd orbita
cargo run --bin orbita -- dev

Write and read a value

In a second terminal:

orbita set default greeting hello
orbita get default greeting

The read returns:

hello

Container quick start

Orbita publishes ghcr.io/orbita-rocks/orbita images. The image exposes client port 7100, private peer port 7101, and stores local state under /var/lib/orbita.

The image defaults to the clustered serve command, which needs an advertised address and cluster configuration. The repository does not yet publish a validated one-line docker run recipe. For a container-based evaluation, use the Docker Compose quick start; it starts three Orbita nodes and MinIO with the required networking and object-store settings.

Choose a client

• Use the Orbita CLI to explore the API.
• Install the Go client for a supported application client.
• Generate standard gRPC stubs by following Authoring clients.
• Python currently uses generated stubs in the conformance suite; a supported SDK is planned.

What the development process includes

The process runs the control plane and one worker together. It creates a default keyspace and one partition, enough to exercise reads, writes, deletes, scans, conditions, and TTLs without first assembling a cluster.

Single-node and multi-node clusters work end to end, including worker registration, replicated writes, control-plane forwarding, and the Admin API. Production hardening and published scale evidence remain incomplete.

Read the full repository quickstart  for the exact list of working and unfinished behavior.