Documentation

Installing with Docker

Running the server as a container.

1. Pull the server image.

   docker pull PLACEHOLDER.URL/cambium-server:0.2.1

2. Make a directory on the host for the repository. Everything the server owns — revisions, blobs, accounts, the TLS cert — lives under this one path, so this is also the only thing you need to back up.

   mkdir -p /srv/cambium/data

3. Run it. The server listens on two ports: one for the desktop client and one reserved for the browser portal.

   docker run -d \
     --name cambium \
     -p PLACEHOLDER_CLIENT_PORT:PLACEHOLDER_CLIENT_PORT \
     -p PLACEHOLDER_PORTAL_PORT:PLACEHOLDER_PORTAL_PORT \
     -v /srv/cambium/data:/data \
     --restart unless-stopped \
     PLACEHOLDER.URL/cambium-server:0.2.1

4. Claim the first account. Read First Time Setup before you hand the address out — the owner account and its one-time password are printed to the log on first boot.
5. Follow the logs if it does not come up.

   docker logs -f cambium

Restarts

The server never restarts itself. Shutdown stops the process cleanly and bringing it back is the operator's job, which is exactly what --restart unless-stopped is for.