Skip to content

Installation mit Docker Compose (empfohlen)

Diese Variante ist schnell, reproduzierbar und leicht zu aktualisieren.

Voraussetzungen

  • Linux/Windows/ macOS mit Docker + Docker Compose v2
  • DNS/Netzwerkzugriff ins Internet (GHCR, Updates)

Benutzer & Pfad vorbereiten

sudo useradd --system --home /opt/ts-connect --shell /usr/sbin/nologin tsconnect || true
sudo mkdir -p /opt/ts-connect
sudo mkdir -p /opt/targetshot-data/uploads
sudo chown -R tsconnect:tsconnect /opt/ts-connect /opt/targetshot-data

Alle Deployments (systemd, Update-Agent, Compose) laufen anschließend unter dem Benutzer tsconnect im Verzeichnis /opt/ts-connect. Profilbilder liegen standardmäßig außerhalb des Repo-Checkouts unter /opt/targetshot-data/uploads.

Schritte (staging‑Beispiel)

  1. Als tsconnect anmelden (sudo -u tsconnect -s) und ins Arbeitsverzeichnis wechseln (cd /opt/ts-connect).
  2. docker-compose.staging.yml und .env bereitstellen (siehe Repo deploy/). Setzt in .env bei Bedarf UPLOADS_DIR=/opt/targetshot-data/uploads oder einen anderen persistenten Host-Pfad.
  3. OWNER setzen (eure GitHub‑Org/Benutzer).
  4. Starten: bash OWNER=<org> docker compose -f docker-compose.staging.yml up -d

Aktualisieren

OWNER=<org> docker compose -f docker-compose.staging.yml pull
OWNER=<org> docker compose -f docker-compose.staging.yml up -d

Integrität prüfen (Checksums)

  1. Öffnet die Releases
  2. Vergleicht checksums.txt mit lokalem Digest oder ladet Images neu per pull

Weitere Hinweise: Erste Schritte