Vos films et vos séries, prêts à regarder.

Le fichier compose

Créez un dossier vide et enregistrez ce fichier sous docker-compose.yml. Tel quel, il fonctionne : l'application répond sur le port 3000 du serveur, et ses données vivent dans un volume nommé.

# Laterna - déploiement minimal
# Aucun .env : les secrets sont générés au premier lancement,
# et chaque réglage se fait dans l'assistant de configuration.

services:
  cine-app:
    image: ghcr.io/lk59/cine-app:latest   # ou :<sha> pour figer une version
    container_name: cine-app
    restart: unless-stopped

    # Accessible depuis le serveur seulement (http://localhost:3000).
    # Derrière un proxy sur le même réseau Docker, retirez ces deux lignes.
    ports:
      - "127.0.0.1:3000:3000"

    # Le réseau Docker de votre proxy inverse (et de Jellyfin, idéalement).
    # networks:
    #   - proxy

    volumes:
      # Base de données, réglages, secrets et journaux : tout l'état de l'app.
      - cine-data:/app/data
      # Optionnel, en lecture seule : vos médias, pour les statistiques.
      # - /chemin/vers/medias:/mnt/media/video:ro

    environment:
      - TZ=Europe/Paris
      # Derrière un proxy HTTPS (étape 3) :
      # - COOKIE_SECURE=true
      # - TRUSTED_PROXIES=nginx-proxy-manager

    # Optionnel : un plafond mémoire.
    # mem_limit: 2g

    healthcheck:
      test: ["CMD", "wget", "-q", "-O", "/dev/null", "http://127.0.0.1:3000/api/ping"]
      interval: 30s
      timeout: 5s
      retries: 3
      start_period: 60s

volumes:
  cine-data:
    name: cine-app-data   # nom fixe, utilisé par les sauvegardes

# networks:
#   proxy:
#     external: true   # le nom donné par `docker network ls`

Pour garder les données dans un dossier ./data à côté du fichier, remplacez la ligne du volume par - ./data:/app/data et créez le dossier avant : mkdir data && sudo chown 1001:1001 data.

Démarrer et vérifier

Au bout d'une minute environ, le conteneur passe à « healthy ».

docker compose up -d
docker compose ps
docker compose logs cine-app | grep "setup code"

Sur une nouvelle installation, les journaux affichent un code d'installation à usage unique. L'assistant le demande pour créer le compte administrateur : seule une personne qui a accès au serveur peut le lire.

Si le conteneur s'arrête, sa dernière ligne de journal en donne la raison. Le cas le plus courant est un dossier ./data qui appartient à root : sudo chown -R 1001:1001 data.

Derrière un proxy inverse

HTTPS active l'installation sur l'écran d'accueil, les notifications et toutes les fonctions du lecteur. Choisissez votre proxy :

large_client_header_buffers 4 32k;
client_max_body_size 110m;

laterna.example.com {
	request_body {
		max_size 110MB
	}
	reverse_proxy cine-app:3000
}

Dans le compose, rattachez l'application au réseau du proxy (les blocs networks), retirez ports, puis décommentez ces deux lignes avec le nom du conteneur de votre proxy :

      - COOKIE_SECURE=true
      - TRUSTED_PROXIES=nginx-proxy-manager   # ou caddy, traefik…

Relancez avec docker compose up -d. Laissez ces deux lignes commentées tant que vous testez en http://.

L'assistant de configuration

Ouvrez votre adresse : l'assistant s'affiche jusqu'à la fin de la configuration. Chaque écran s'enregistre quand vous appuyez sur Suivant, et teste le service que vous venez de renseigner.

1. Bienvenuela langue de l'installation
2. Comptele code d'installation, puis l'administrateur local
3. Jellyfinadresse et clé d'API, vues depuis le conteneur
4. TMDBla clé d'API
5. BibliothèqueRadarr et Sonarr, facultatifs
6. ExtrasJellyseerr, qBittorrent, Bazarr, notes, lecture
7. Déploiementles options du compose, avec la ligne à copier
8. Terminerle récapitulatif de ce qui est disponible

Les adresses sont vues depuis le conteneur : utilisez le nom du conteneur (http://jellyfin:8096) sur un réseau Docker partagé, ou l'adresse du serveur sur le réseau local.

Et ensuite

Les spectateurs se connectent avec leur compte Jellyfin, et les administrateurs Jellyfin sont administrateurs de Laterna.

docker compose pull && docker compose up -d

docker compose stop
docker run --rm -v cine-app-data:/data -v "$PWD":/backup alpine \
  tar czf /backup/laterna-$(date +%F).tgz --exclude=./image-cache -C /data .
docker compose start

Les migrations s'appliquent au démarrage, et les onglets ouverts passent à la nouvelle version entre deux lectures. Gardez config/secrets.json dans chaque sauvegarde.