Storage Node operations

The Storage Node is a long-running Rust daemon. It can be run interactively for setup and diagnostics, or non-interactively as a system service.

Data directoryCopy Anchor Link

Chosen on first run (see Run a Storage Node). It contains:

<data-dir>/
  nodus.db           # SQLite catalogue (WAL mode)
  objects/           # content-addressed encrypted shards
  temp/              # in-progress atomic writes

SQLite runs with foreign_keys=ON, journal_mode=WAL, busy_timeout=5000, and synchronous=FULL.

Configuration fileCopy Anchor Link

~/.nodus/config.toml:

data_dir = "/home/user/NodusBackup"
relay_url = "https://relay.nodus.example.com"

relay_url is only persisted after a successful pairing. Relay URL precedence is: CLI --relay → config.toml → NODUS_RELAY_URL → none (it never defaults to localhost, so a misconfigured node cannot silently pair to the wrong Relay).

Environment variablesCopy Anchor Link

Run as a serviceCopy Anchor Link

Use nodus node start in a systemd unit. With no TTY, a bare nodus also boots the daemon directly. Point stdin at the unit's journal.

[Service]
ExecStart=/usr/local/bin/nodus node start
Environment=NODUS_DATA_DIR=/var/lib/nodus
Restart=on-failure

Interactive shellCopy Anchor Link

When the daemon runs on a TTY it exposes a shell with commands:

Moving the data directoryCopy Anchor Link

Use Change data location in the menu. An interrupted move is journaled in ~/.nodus/migration.json and completed on the next boot.

RelatedCopy Anchor Link

• Storage Node CLI reference
• Factory reset