Installation Docker

Déployer VidArch avec les fichiers Compose du dépôt, des volumes persistants et le durcissement.

Le dépôt fournit deux fichiers Compose. Ils ne sont pas interchangeables.

Fichier	Source d'image	Quand l'guide
`docker-compose.yml`	build local étiqueté `vidarch:local`	valider ou exécuter le checkout courant
`docker-compose.example.yml`	`${VIDARCH_IMAGE:-ghcr.io/lucas-lepajollec/vidarch:latest}`	instance homelab depuis l'image publiée

Les deux lient 127.0.0.1:2499:2499 par défaut, montent ./data et ./downloads, utilisent une racine en lecture seule, retirent toutes les capacités et contrôlent http://127.0.0.1:2499/api/health à l'intérieur du conteneur.

Homelab depuis l'image publiée

Copiez docker-compose.example.yml dans un dossier dédié sous le nom docker-compose.yml, ou partez de cet équivalent :

services:
  vidarch:
    image: ${VIDARCH_IMAGE:-ghcr.io/lucas-lepajollec/vidarch:latest}
    container_name: vidarch
    restart: unless-stopped
    ports:
      - "${VIDARCH_BIND_ADDRESS:-127.0.0.1}:2499:2499"
    environment:
      PORT: 2499
      NODE_ENV: production
      DATA_DIR: /app/data
      DOWNLOADS_DIR: /app/downloads
      AUTH_PASSWORD: ${AUTH_PASSWORD:-}
    volumes:
      - ./data:/app/data
      - ./downloads:/app/downloads
    read_only: true
    tmpfs:
      - /tmp:size=128m,uid=1000,gid=1000,mode=1770
    security_opt:
      - no-new-privileges:true
    cap_drop:
      - ALL
    init: true
    healthcheck:
      test: ["CMD", "curl", "--fail", "--silent", "http://127.0.0.1:2499/api/health"]
      interval: 30s
      timeout: 5s
      retries: 3
      start_period: 20s

Créez un .env à côté :

AUTH_PASSWORD=choose-a-long-unique-passphrase

Épinglez une image récupérable avant de dépendre de l'instance :

export VIDARCH_IMAGE=ghcr.io/lucas-lepajollec/vidarch:sha-<full-commit>
docker compose up -d

Ouvrez http://127.0.0.1:2499, puis suivez le premier démarrage. Définissez VIDARCH_BIND_ADDRESS=0.0.0.0 seulement après avoir configuré un mot de passe, et uniquement pour un LAN de confiance.

Construire le checkout courant

docker compose up -d --build

Ce Compose construit vidarch:local. N'exécutez pas docker compose pull contre lui.

N'exécutez jamais docker compose down -v pour un arrêt normal. Sauvegardez data/ et downloads/ avant de remplacer une image en cours.

Installation Docker

Homelab depuis l'image publiée

Construire le checkout courant

Sur cette page