Getting Started

Bring up the local core fast.

NexusFS already boots as a local-first daemon with persistent storage and an embedded admin interface. The commands below are the fastest path to a working system.

cargo build -p nexusfs
cargo run -p nexusfs -- daemon --config examples/nexusfs.toml
cargo run -p nexusfs -- status --config examples/nexusfs.toml

What happens on first run

  • The daemon opens the local storage backend.
  • A persistent device identity is created if missing.
  • An initial repository head is bootstrapped.
  • The admin surface starts with a generated access token.

What is already implemented

  • Canonical object encoding and deterministic hashing
  • Chunked blob storage with offsets and lengths
  • Persistent snapshot heads
  • Idempotent minimal oplog application scaffolding