Busabase auf Ihrem eigenen Server installieren

Ein Container zum Ausprobieren, Compose für den Produktivbetrieb. Alles unten ist copy-paste; nichts muss vorher mit einem Platzhalter ausgefüllt werden.

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 \
  -e APP_URL=http://localhost:3000 \
  -v busabase-data:/data \
  --restart unless-stopped \
  busabase/busabase-premium-allinone:latest

git clone https://github.com/busabase/busabase-premium.git
cd busabase-premium/compose

# Generates .env and seaweed-s3.json with matching random credentials.
# Doing this by hand is the single most common cause of "the app starts
# but every attachment upload fails".
./init.sh

BUSABASE_IMAGE=busabase/busabase-premium:latest docker compose up -d

git clone https://github.com/busabase/busabase-premium.git
helm install busabase ./busabase-premium/helm \
  --namespace busabase --create-namespace \
  --set image.tag=<version> \
  --set appUrl=https://busabase.company.internal

# Bring your own Postgres and S3 (recommended for production):
#   --set postgres.mode=external --set postgres.external.host=pg.company.internal
#   --set storage.mode=external  --set storage.publicHost=s3.company.internal

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

kubectl logs -l app.kubernetes.io/name=busabase-premium --tail=500 > sb-logs.txt
kubectl get pods -l app.kubernetes.io/name=busabase-premium -o wide > sb-pods.txt
tar czf busabase-support.tar.gz sb-logs.txt sb-pods.txt