Remote Spaces

A Remote Space belongs to a Federation Organization. The Duobox Server stores a bare Git repository; each user works in a complete local clone.

Create or open from the App

Open the Space selector and choose an Organization. Users with manager access can create a project; members can open an existing project and choose a local directory. The App obtains the clone endpoint from Organization and Space metadata, so users do not paste Git URLs.

Use the CLI

duobox space list --organization <id-or-key>
duobox space create . --organization <id-or-key> --name "Project name"
duobox space clone <space-id> ./project --organization <id-or-key>
duobox space settings ./project

Connection information lives in the Git remote. Duobox does not create .duobox/space.json, and it never places a server database inside the Space directory.

What Sync does

Core Sync flushes open documents, creates a local checkpoint, fetches main, integrates compatible remote changes, and pushes when authorized. Conflicts remain in the local clone for resolution; a failed network request never deletes local edits.

.downcity/ and .duobox/ contain machine-local runtime state. The App and CLI maintain .gitignore and automatically stop tracking these directories without deleting local files. For real content conflicts, resolve each file by keeping your version, using the remote version, or editing it manually before continuing.

The Git extension remains useful for status, staging, history, branches, and manual Git operations. Organization access and Core Sync belong to Duobox Core and continue to work without the Git extension.

Files and size limits

Text and ordinary images can be committed normally. A server hook rejects any individual Git blob larger than 20 MiB. Keep video and large binary assets outside the Space until Git LFS support is available.