ZAPTVIO Server — Préversion technique du 27 octobre 2026

ÉTAT DE CETTE VERSION
Ce paquet fournit les sources et les fichiers Docker Compose nécessaires à une
construction locale. Ce n'est pas une image Docker précompilée ni une version
commerciale finale. Le serveur a été testé sur Linux amd64, sur Synology DS220+.
Aucune validation ARM ou Windows n'est annoncée.

L'activation Pro de production dépend encore de la première publication App Store.
L'identifiant numérique Apple de l'application et les achats réels restent à
finaliser. Le paquet impose le mode production : aucun déblocage Pro de développement
n'est activé. Ne substituez pas un identifiant inventé à ZAPTVIO_APP_APPLE_ID.
Vous pouvez examiner et préparer l'installation ; l'activation des enregistrements
reste conditionnée à la disponibilité du produit et à un achat Pro vérifié.

PRÉPARATION
1. Installez Docker Engine avec Docker Compose, ou Container Manager sur Synology.
2. Extrayez le paquet dans un dossier dédié. Conservez INSTALLATION.txt.
3. Créez deux dossiers vides : config et recordings.
4. Copiez .env.example en .env. Indiquez l'adresse locale de votre serveur et
   l'adresse de son interface réseau. Utilisez les UID/GID du compte qui possède
   config et recordings (commande id). Le service ne doit pas tourner en root.
5. Lorsque l'identifiant App Store de production est disponible, renseignez-le.
6. Depuis le dossier du projet :
   docker compose config --quiet
   docker compose build
   docker compose up -d
   Sur Synology, vous pouvez aussi importer le projet dans Container Manager.

PREMIER LANCEMENT
Ouvrez le lien privé contenu dans config/setup-link.txt depuis votre réseau local.
Le lien expire après 30 minutes. Définissez un mot de passe administrateur d'au
moins 12 caractères. Pour renouveler un lien non utilisé :
   docker compose exec zaptvio-server python -m zaptvio_server.admin setup
Ne partagez ni ce lien, ni la configuration, ni les clés du serveur.

ASSOCIATION À L'APPLE TV
Dans Mon serveur, créez un lien d'association. Il est valable cinq minutes et
utilisable une seule fois. Ajoutez-le dans ZAPTVIO > Réglages > Lecture >
Téléchargements et DVR > ZAPTVIO Server, ou via l'interface web locale de ZAPTVIO.
Choisissez ensuite ZAPTVIO Server comme moteur des futurs enregistrements.
Jellyfin se configure séparément ; Gelato n'est pas inclus dans ce paquet.

RÉSEAU ET FLUX
HTTPS utilise le port 8443 sur votre réseau local. Ne publiez pas ce port sur
Internet. L'app vérifie le certificat associé. Le VPN de l'Apple TV ne couvre pas
le NAS. Chaque enregistrement utilise une connexion à votre fournisseur : respectez
la limite de votre abonnement, y compris lorsque vous regardez une chaîne en même temps.
Aucune chaîne, playlist ou offre de contenus n'est fournie.

MISE À JOUR ET SAUVEGARDE
Conservez ensemble la base de données, secrets.key, les certificats et leurs clés,
ainsi que les vidéos. Arrêtez le conteneur avant une copie complète de sauvegarde.
Évitez les mises à jour pendant un enregistrement. Relancez docker compose build
puis docker compose up -d en conservant les dossiers montés. N'utilisez pas down -v.
Consultez README.md, ACCESS.md et COMMERCIALS.md pour les limites détaillées.