Duobox Server

Duobox Server manages Spaces, Git repositories, project ACL, and synchronization authorization. Downcity Federation manages Organizations and Membership. A server instance binds to one Federation and City.

Initialize and run

duobox server init
duobox server start
duobox server status

Initialization writes ~/.duobox/server.env with permission 0600 and asks for the Federation URL, Bureau Token, City ID, listen address, public URL, and data directory. The Bureau Token is not echoed.

server start launches a background process and returns the terminal after its health check passes. Runtime files are stored in the configured data directory:

• server.pid records the managed process;
• server.log contains background logs;
• the SQLite database stores Spaces, project ACL, and audit data;
• bare repositories store Space content and history.

duobox server restart
duobox server stop
duobox server start --foreground

Use start --foreground only for foreground debugging or when systemd, Docker, or Dokploy owns the process lifecycle. Plain start lets Duobox manage its own background process.

Organization setup and access

duobox login
duobox server organization list
duobox server organization link <organization-id-or-key>
duobox server organization access list <organization-id>
duobox server organization access set <organization-id> <user-id> --role editor
duobox server organization access remove <organization-id> <user-id>

Back up the configured data directory as one unit. The database and bare repositories must remain consistent.