Quickstart

Install Busabase on your own server with one command, check it actually worked, and activate your licence — including on a network with no internet access.

This is the same guide published at busabase.com/self-hosted/install. It is repeated here because the docs ship inside the image: on a network that cannot reach busabase.com, this page still opens.

Was der Host benötigt

CPU

2 vCPU

Arbeitsspeicher

2 GB

Festplatte

10 GB

Offener Port

3000 + 8333/tcp

Gemessen bei einem Kaltstart mit leerem Volume: 24 s bis zu einem gesunden Server, 548 MiB im Leerlauf, 50 MB in /data nach dem ersten Start. Zwei Ports: die App und der Objektspeicher — der Browser lädt Anhänge direkt aus dem Speicher, daher muss dieser erreichbar sein. Postgres bleibt innerhalb des Containers.

docker run -d --name busabase \
  -p 3000:3000 \
  -p 8333:8333 \
  -v busabase-data:/data \
  --restart unless-stopped \
  busabase/busabase-premium-allinone:trial

Prüfen, ob es funktioniert hat

Verlassen Sie sich nicht darauf, dass der Container läuft. Fragen Sie den Server selbst — er antwortet, bevor sich irgendjemand anmeldet.

curl -s http://localhost:3000/api/health

Ein gesunder Server antwortet mit:

{"status":"ok","service":"busabase","version":"0.10.0", ...}

Lizenz aktivieren

Öffnen Sie den Server, melden Sie sich als Administrator an und gehen Sie zu Systemverwaltung → Lizenz. Fügen Sie dort den Aktivierungscode ein; er wird direkt auf der Maschine geprüft und benötigt keinen Internetzugang. Codes werden in Ihrem Busabase-Cloud-Konto unter Einstellungen → Self-Hosting-Lizenz ausgestellt.

Installation in einem Netzwerk ohne Internetzugang

Übertragen Sie das Image als Datei. Das Tarball ist etwa 489 MB groß; prüfen Sie nach der Übertragung den Hash, denn eine abgebrochene Übertragung zeigt sich sonst erst viel später als verwirrender Laufzeitfehler.

# On a machine with internet access
docker pull busabase/busabase-premium-allinone:latest
docker save busabase/busabase-premium-allinone:latest -o busabase-premium-allinone.tar
sha256sum busabase-premium-allinone.tar > busabase-premium-allinone.tar.sha256

# Move both files to the target host, then
sha256sum -c busabase-premium-allinone.tar.sha256
docker load -i busabase-premium-allinone.tar

Der Server startet nicht

Erstellen Sie ein Diagnosepaket und senden Sie es an support@busabase.com. Es enthält Logs, Health-Check-Ausgaben und Image-Metadaten — keine Zugangsdaten: Die generierten Secrets werden nach /data/.credentials geschrieben und nie protokolliert.

docker logs --tail 500 busabase > sb-logs.txt 2>&1
curl -s http://localhost:3000/api/health > sb-health.json
docker inspect busabase --format '{{.Config.Image}} {{.State.Status}}' > sb-meta.txt
tar czf busabase-support.tar.gz sb-logs.txt sb-health.json sb-meta.txt

What happens on first boot

The container generates its own credentials — the Postgres password, the object-storage keys, the session secret — writes them to /data/.credentials with mode 600, and reuses them on every later start. Nothing is baked into the image, so two people who pull the same image do not end up sharing secrets.

It then runs the database migrations and starts the app. On an empty volume this takes about 24 seconds end to end, most of it Postgres initialising itself for the first time. Later restarts skip both and are much faster.

Back up /data/.credentials along with your data. It is the only copy of those secrets — regenerating them would leave you with a database you cannot open.

Setting up for real use → Production with Compose
Activating or renewing → Licensing
Something went wrong → Troubleshooting