Collaboration and server troubleshooting
Diagnose login, Organization, Federation, server, sync, and file-size errors.
An Organization Server route is not found
The App and Duobox Server are running incompatible versions, or the App points to an older server process. Upgrade both, restart the server, and confirm duobox server status reports the expected public URL.
Federation is unavailable
The Duobox Server could not identify the App's Federation token. Check the server's network access to its configured Federation, Bureau Token, and City ID. This is an authentication dependency, not a Git error. Duobox reports the failure directly and does not hide it behind repeated retries.
An Organization is missing
Confirm the active Federation account has active Membership and that organizations/my returns the Organization. Archived Organizations are not available for Space access.
I cannot create a Space
Only users with Duobox manager access can create Spaces. Organization Owner and Admin receive manager; Editor and Viewer can open existing Spaces. Verify the active account and role in Organization settings.
The server occupies my terminal
Use duobox server start for normal background operation. duobox server start --foreground intentionally stays attached for debugging or when systemd, Docker, or Dokploy manages the process. Press Ctrl+C to stop a foreground process; use duobox server stop for a background process.
Push or sync is rejected
Confirm that Membership is active and the Duobox role is manager or editor. The server also rejects force pushes, deletion of main, non-main branch updates, and individual blobs larger than 20 MiB.
How do I resolve a sync conflict?
The conflict panel lists real content files. Choose Keep mine or Use remote for each file, or edit conflict markers manually, save, and select Continue sync. Abort sync exits the rebase and preserves the local changes from before syncing.
.downcity/ and .duobox/ are machine-local runtime state and never require manual merging. Duobox automatically stops tracking them while preserving the local files.