Installation Docker

VidArch utilise le port 2508 sur l'hôte Docker et 2508 dans le conteneur de production. Le développement depuis les sources reste séparé sur 2499 (interface) et 2498 (API).

Docker Compose prêt à copier

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

Démarrez puis vérifiez le service :

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

Les deux premières commandes préparent les bind mounts Linux pour l'UID/GID non-root 1000:1000 de l'image. Docker Desktop gère normalement lui-même le partage des fichiers hôtes. Pour une médiathèque partagée existante, utilisez la méthode ACL de la page Stockage ; n'utilisez jamais chmod 777.

Ouvrez http://<ip-serveur>:2508 depuis le LAN, ou http://localhost:2508 sur l'hôte Docker. Aucun .env n'est requis ; ce fichier optionnel sert uniquement aux surcharges avancées de démarrage comme AUTH_PASSWORD. Au premier démarrage, définissez un mot de passe dans Paramètres → Sécurité avant de rendre le service accessible hors d'un LAN de confiance. L'image s'exécute déjà avec l'utilisateur node non-root et contient son propre healthcheck sur le port 2508 ; Compose ne répète pas ces réglages.

Les deux montages sont nécessaires : data contient la base, les sessions, la configuration et les cookies ; downloads contient la médiathèque possédée. Sauvegardez-les ensemble lorsque VidArch est arrêté.

Construire depuis les sources

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

L'override construit vidarch:local sans changer le port 2508 ni les dossiers persistants. N'utilisez jamais docker compose down -v pour une mise à jour normale. Voir Premier démarrage et Mises à jour.