Commencer

Télécharger et installer

Installez le serveur multimédia ZiiX.TV avec Docker en quelques minutes, sur un NAS, un serveur domestique ou une machine Linux. Images amd64 et arm64.

ZiiX.TV est un serveur que vous faites tourner vous-même, avec Docker. Il fonctionne sous Linux sur amd64 et arm64 : un NAS, un serveur domestique, un mini PC ou un Raspberry Pi 4/5. Vos fichiers multimédias restent où ils sont ; ZiiX.TV se contente de les lire.

1. Créez un dossier avec deux fichiers

Créez un dossier pour ZiiX.TV, par exemple /opt/ziix-tv, et placez-y ce docker-compose.yml :

services:
  ziix-tv:
    image: ziixeu/ziix-tv:latest
    container_name: ziix-tv
    restart: unless-stopped
    ports:
      - "8470:8470"
    volumes:
      - ./config:/config
      - ${ZIIX_MEDIA:-./media}:/media:ro
      - ${ZIIX_PREVIEWS:-./previews}:/previews
    cap_drop: [ALL]
    cap_add: [CHOWN, FOWNER, DAC_OVERRIDE, SETUID, SETGID]
    security_opt:
      - no-new-privileges:true
    environment:
      PUID: ${PUID:-1000}
      PGID: ${PGID:-1000}
      TZ: ${TZ:-Europe/Copenhagen}
      ZIIX_TMDB_API_KEY: ${ZIIX_TMDB_API_KEY:-}
      ZIIX_TVDB_API_KEY: ${ZIIX_TVDB_API_KEY:-}
      ZIIX_TVDB_PIN: ${ZIIX_TVDB_PIN:-}
      ZIIX_METADATA_LANGUAGE: ${ZIIX_METADATA_LANGUAGE:-en-US}
      ZIIX_SCAN_INTERVAL: ${ZIIX_SCAN_INTERVAL:-15m}
      ZIIX_HWACCEL: ${ZIIX_HWACCEL:-auto}
      ZIIX_PREVIEW_DIR: /previews

À côté, un fichier nommé .env qui indique où se trouvent vos médias et quel utilisateur peut les lire. La commande id sur le serveur affiche vos numéros d’utilisateur et de groupe.

ZIIX_MEDIA=/path/to/media
PUID=1000
PGID=1000
TZ=Europe/Copenhagen
ZIIX_METADATA_LANGUAGE=en-US

2. Démarrez-le

docker compose up -d

Ouvrez http://<your server>:8470 dans un navigateur et créez l’administrateur. Le premier compte créé est celui de l’administrateur du serveur.

3. Ajoutez vos bibliothèques

Dans Paramètres → Bibliothèques, ajoutez une bibliothèque pour les films et une pour les séries, qui pointent vers leurs dossiers sous /media. ZiiX.TV les analyse aussitôt. Voir comment nommer vos fichiers et comment ajouter une bibliothèque.

4. Regardez

Regardez dans le navigateur, ou installez une appli et associez-la à votre serveur.

AppliOù
Navigateur webIntégré : http://<your server>:8470
Apple TVApp Store (bientôt disponible)
iPhone et iPadApp Store (bientôt disponible)
AndroidGoogle Play (bientôt disponible)
Android TVPrévu

Mise à jour

docker compose pull
docker compose up -d

latest est toujours la version la plus récente. Pour rester sur une version précise, utilisez plutôt son tag, par exemple ziixeu/ziix-tv:0.9.1. Les mises à jour conservent vos bibliothèques, vos utilisateurs et votre historique de visionnage ; faites tout de même d’abord une copie du dossier config.

Carte graphique NVIDIA

Avec le pilote NVIDIA et le NVIDIA Container Toolkit installés sur le serveur, ZiiX.TV peut convertir la vidéo sur la carte graphique. Ajoutez un second fichier, docker-compose.nvidia.yml :

services:
  ziix-tv:
    deploy:
      resources:
        reservations:
          devices:
            - driver: nvidia
              count: all
              capabilities: [gpu]

puis démarrez avec les deux fichiers :

docker compose -f docker-compose.yml -f docker-compose.nvidia.yml up -d

Plus d’informations dans GPU et transcodage.

Dossiers

Dans le conteneurContenu
/configBase de données et paramètresÀ sauvegarder
/mediaVos films et sériesLa lecture seule suffit
/previewsImages de la barre de progressionPeuvent être recréées, mais cela prend des heures pour une grande bibliothèque

ZiiX.TV démarre en root uniquement pour attribuer /config et /previews à PUID:PGID, puis s’exécute sous cet utilisateur, sans privilèges.

Essai et licence

Un nouveau serveur fonctionne en essai de 30 jours, tout compris, sans carte bancaire. Quand vous êtes prêt, achetez une licence dans Paramètres → Serveur. Voir tarifs.