Skip to content
Docs

Install and run

Terminal window
docker run -d --name rackend -v rackend_data:/data -p 8080:8080 ghcr.io/axanet/rackend:0.0

No environment variables are required. Everything except the few bootstrap variables is configured at runtime in the admin UI at /_/.

The image is published for linux/amd64 and linux/arm64. Pin the minor version (x.y, here 0.0) so upgrades are deliberate: the tag always points at the newest patch release of that minor version.

docker-compose.yml
services:
rackend:
image: ghcr.io/axanet/rackend:0.0
restart: unless-stopped
ports: ["8080:8080"]
volumes: ["rackend_data:/data"]
stop_grace_period: 30s
volumes:
rackend_data:

rackend keeps everything in one data directory (/data in the container):

Path Contents
rackend.lock Exclusive lock, held while the instance runs
data.db Main SQLite database (+ -wal, -shm)
logs.db Request logs and metrics; losing it is harmless
storage/ Uploaded files (local filesystem backend)
backups/ Pre-upgrade, manual and scheduled backups
tmp/ Upload staging, wiped at startup

The container runs as UID/GID 10001:10001. Bind mounts must be writable by that user.

Uploaded files go to storage/ unless you choose an S3-compatible bucket.

Without RACKEND_SUPERUSER_EMAIL/_PASSWORD, rackend logs a one-time link on every start until the first superuser exists:

Open http://localhost:8080/_/setup?token=… to create the first superuser.

The setup screen also asks for the public URL users reach the instance at.

The first-start setup screen of the admin UI, asking for the superuser account and the public URL.The first-start setup screen of the admin UI, asking for the superuser account and the public URL.

On SIGTERM/SIGINT rackend stops accepting connections, waits up to 10 s for in-flight requests, finishes queued database writes, checkpoints the databases and exits 0. Give the container at least 30 s (stop_grace_period). Other exit codes are listed in Exit codes.