Docker-Installation

VidArch verwendet Port 2508 auf dem Docker-Host und 2508 im Produktionscontainer. Die lokale Quellcode-Entwicklung bleibt getrennt auf 2499 (Oberfläche) und 2498 (API).

Kopierfertiges Docker Compose

services:
  vidarch:
    image: ghcr.io/lucas-lepajollec/vidarch:latest
    ports:
      - "2508:2508"
    env_file:
      - path: .env
        required: false
    volumes:
      - ./data:/app/data
      - ./downloads:/app/downloads
    init: true
    restart: unless-stopped

Starte und prüfe den Dienst:

mkdir -p data downloads
sudo chown -R 1000:1000 data downloads
docker compose pull
docker compose up -d --force-recreate
docker compose ps

Die ersten beiden Befehle bereiten Linux-Bind-Mounts für die Nicht-Root-UID/GID 1000:1000 des Images vor. Docker Desktop verwaltet die Freigabe von Hostdateien normalerweise selbst. Verwende für eine vorhandene gemeinsame Medienbibliothek die ACL-Methode unter Speicher; verwende niemals chmod 777.

Öffne http://<server-ip>:2508 im LAN oder http://localhost:2508 auf dem Docker-Host. Eine .env ist nicht erforderlich; die optionale Datei dient nur erweiterten Startwerten wie AUTH_PASSWORD. Lege beim ersten Start unter Einstellungen → Sicherheit ein Passwort fest, bevor der Dienst außerhalb eines vertrauenswürdigen LAN erreichbar ist. Das Image läuft bereits als Benutzer node ohne Root-Rechte und enthält seinen eigenen Healthcheck auf Port 2508; Compose wiederholt diese Einstellungen nicht.

Beide Mounts sind erforderlich: data enthält Datenbank, Sitzungen, Konfiguration und Cookies; downloads enthält die Medienbibliothek. Sichere beide gemeinsam bei gestopptem VidArch.

Aus dem Quellcode bauen

git clone https://github.com/lucas-lepajollec/vidarch.git
cd vidarch
docker compose -f docker-compose.yml -f docker-compose.build.yml up -d --build

Das Overlay baut vidarch:local, ohne Port 2508 oder die persistenten Verzeichnisse zu ändern. Verwende bei normalen Updates nie docker compose down -v. Siehe Erster Start und Aktualisierungen.