Jellyfin : streaming vidéo self-hosted pour formations entreprise — Hetzner 2026

Introduction

Dans une PME ouest-africaine en croissance, la gestion des ressources vidéo internes pose rapidement un problème concret : où stocker les enregistrements des formations dispensées en salle, les replays des webinaires internes, les tutoriels métier produits par les équipes senior, les archives des conférences OHADA ou des sessions de mise à niveau réglementaire ? La réponse instinctive est souvent YouTube (privatisé) ou un dossier Google Drive partagé. Ces deux options présentent des limites sérieuses : dépendance à une connexion stable, absence de contrôle sur qui consulte quoi, risque de fuite de données sensibles, et coût croissant dès que le volume dépasse quelques gigaoctets.

Jellyfin est une alternative radicalement différente. C’est un serveur média libre (free and open-source), publié sous licence GPL-2.0, développé activement sur github.com/jellyfin/jellyfin et documenté sur jellyfin.org. Il s’installe sur n’importe quel serveur Linux, expose une interface web responsive accessible depuis un navigateur, et fournit des applications natives pour Android, iOS, Android TV, Fire TV et Roku. Contrairement à Plex, son concurrent le plus connu, Jellyfin ne requiert aucun compte cloud, aucun abonnement et ne collecte aucune donnée utilisateur. Pour une PME qui souhaite garder le contrôle total sur ses ressources pédagogiques, c’est un choix évident.

Ce tutoriel couvre l’installation complète de Jellyfin sur un VPS Hetzner CX22, la configuration d’une bibliothèque dédiée aux formations internes, la gestion des droits par équipe, l’activation du transcodage matériel et les bonnes pratiques de sauvegarde. Comptez environ trente minutes pour avoir un serveur opérationnel.

Prérequis

• Serveur : Hetzner CX22 (2 vCPU AMD, 4 Go RAM, 40 Go SSD NVMe, Ubuntu 22.04 LTS) — suffisant pour un usage PME jusqu’à 20 utilisateurs simultanés sans transcodage matériel
• Stockage additionnel : volume Hetzner attaché (ex. 100 Go à 4,55 €/mois) pour les fichiers vidéo, séparé du système
• Docker et Docker Compose v2 : installés (voir tutoriel frère Docker sur VPS)
• Nom de domaine : sous-domaine pointant sur le serveur (ex. media.monentreprise.com) avec certificat SSL via Traefik ou Nginx Proxy Manager
• GPU optionnel : les VPS Hetzner CPX/CCX n’embarquent pas de GPU dédié ; le transcodage software (libx264) est fonctionnel sur CX22 pour les formats H.264 720p ; pour du 1080p multi-flux, prévoir un serveur dédié avec Intel Quick Sync ou une machine on-premise avec NVENC
• Temps estimé : ~30 minutes pour l’installation de base, ~1 heure pour la configuration complète avec bibliothèques et utilisateurs

Étape 1 — Pourquoi Jellyfin pour l’entreprise, et non Plex

La question revient souvent dans les équipes techniques : Plex est plus connu, son interface est soignée, pourquoi ne pas l’utiliser ? La réponse tient en trois points structurants pour un contexte PME africaine.

Le premier est la souveraineté des données. Plex exige que chaque serveur soit associé à un compte plex.tv. Même si vos fichiers restent sur votre machine, les métadonnées, les préférences de lecture et les statistiques d’utilisation transitent par les serveurs Plex Media Inc. (États-Unis). Pour une entreprise soumise à la réglementation ARTCI en Côte d’Ivoire ou à la Commission de Protection des Données Personnelles au Sénégal, stocker des données comportementales d’employés chez un tiers américain sans consentement explicite est problématique. Jellyfin ne contacte aucun serveur externe par défaut — tout est local.

Le deuxième est le modèle économique. Plex Pass (abonnement annuel ~40 USD) est nécessaire pour débloquer le transcodage mobile, la synchronisation hors-ligne et le partage multi-utilisateurs avancé. Ces fonctionnalités sont disponibles gratuitement dans Jellyfin sans aucune restriction. À l’échelle d’une PME de 30 personnes sur 3 ans, c’est une économie non négligeable.

Le troisième est la personnalisation et l’intégration. Jellyfin expose une API REST complète, un système de plugins actif (plugins officiels sur jellyfin.org/docs) et s’intègre nativement avec LDAP/Active Directory pour les grandes structures. Pour une PME qui a déjà un annuaire interne, l’intégration SSO est possible via le plugin LDAP Authentication, sans dépendre d’un service externe.

En résumé : Jellyfin est l’outil de la PME qui prend sa souveraineté numérique au sérieux. Plex est une solution grand public qui tolère l’usage professionnel mais n’est pas conçue pour lui.

Étape 2 — Déployer Jellyfin via Docker Compose

Docker Compose est la méthode recommandée par la documentation officielle Jellyfin pour les déploiements en production sur Linux. Elle isole le processus, simplifie les mises à jour (docker compose pull && docker compose up -d) et permet de versionner la configuration dans un dépôt Git interne.

Commencez par créer la structure de répertoires sur votre serveur. Cette organisation sépare la configuration Jellyfin, le cache (qui peut grossir significativement) et les données médias proprement dites :

# Créer les répertoires de travail
mkdir -p /opt/jellyfin/{config,cache}
mkdir -p /mnt/medias/formations   # ou /mnt/volume-hetzner/formations
chmod 755 /opt/jellyfin
chmod 755 /mnt/medias

Une fois la structure en place, créez le fichier docker-compose.yml dans /opt/jellyfin/ :

version: "3.8"

services:
  jellyfin:
    image: jellyfin/jellyfin:latest          # image officielle Docker Hub
    container_name: jellyfin
    user: "1000:1000"                        # UID/GID de l'utilisateur système (non-root)
    network_mode: host                       # nécessaire pour la découverte DLNA/UDP
    volumes:
      - /opt/jellyfin/config:/config         # configuration persistante
      - /opt/jellyfin/cache:/cache           # transcodes temporaires et thumbs
      - /mnt/medias:/media:ro                # bibliothèques en lecture seule
    restart: unless-stopped
    environment:
      - JELLYFIN_LOG_DIR=/config/log
      - TZ=Africa/Abidjan                    # adapter selon le fuseau (Africa/Dakar, etc.)

Notez l’option :ro (read-only) sur le volume des médias : Jellyfin n’a jamais besoin d’écrire dans vos fichiers sources. C’est une bonne pratique de sécurité qui protège vos archives contre toute corruption accidentelle. Lancez le conteneur avec docker compose up -d depuis /opt/jellyfin/, puis vérifiez qu’il tourne avec docker compose ps. L’interface web est accessible sur le port 8096 de votre serveur. Si vous utilisez un reverse proxy (Traefik, Nginx), exposez ce port en interne uniquement et laissez le proxy gérer le SSL sur le port 443.

Au premier lancement, Jellyfin affiche un assistant de configuration initiale dans le navigateur. Choisissez la langue (français disponible), créez le compte administrateur et définissez le fuseau horaire. Ne configurez pas encore les bibliothèques à ce stade — c’est l’objet de l’étape suivante.

Étape 3 — Configurer la bibliothèque « Formations internes »

Une bibliothèque Jellyfin est une collection de dossiers partageant le même type de contenu et les mêmes règles de métadonnées. Pour un usage professionnel, il est fortement recommandé de créer des bibliothèques séparées par thématique ou par niveau de confidentialité, plutôt qu’une seule bibliothèque fourre-tout. Cette organisation facilitera ensuite la gestion des droits par équipe.

Dans l’interface d’administration (Menu ☰ → Tableau de bord → Bibliothèques → Ajouter une bibliothèque), sélectionnez le type de contenu « Films » pour les vidéos professionnelles. Ce choix peut surprendre, mais c’est le type de bibliothèque qui offre le plus de flexibilité pour les vidéos sans structure de saison. Nommez la bibliothèque « Formations internes » et ajoutez le chemin /media/formations.

Désactivez les sources de métadonnées automatiques (TheMovieDB, IMDb) qui n’ont aucune pertinence pour des vidéos internes et ralentiraient les scans. Dans les options de la bibliothèque, décochez toutes les sources externes et activez uniquement « Local NFO » si vous souhaitez gérer les métadonnées manuellement via des fichiers .nfo placés à côté de chaque vidéo. Un fichier NFO minimal ressemble à ceci :

  
  Tableaux croisés dynamiques, Power Query, macros VBA introduction.
  2026
  Formation interne

Une fois la bibliothèque créée, Jellyfin lance un scan automatique des fichiers présents dans le dossier. Le scan indexe les fichiers, génère les miniatures (thumbnails) à partir d’une frame extraite de chaque vidéo, et les rend disponibles dans l’interface. Pour les vidéos longues (conférences de 2h+), vous pouvez poser une image .jpg du même nom que la vidéo pour servir de miniature personnalisée — ce qui est bien plus informatif qu’une frame aléatoire.

Étape 4 — Utilisateurs et permissions par dossier

La gestion des accès est l’une des fonctionnalités les plus utiles de Jellyfin pour un usage professionnel. Le principe est simple : chaque utilisateur ne voit que les bibliothèques auxquelles il a été explicitement autorisé. Un stagiaire n’a pas besoin d’accéder aux archives de direction ; l’équipe terrain au Mali n’a besoin que des formations qui concernent son activité.

Pour créer un utilisateur, allez dans Tableau de bord → Utilisateurs → Ajouter un utilisateur. Définissez un nom d’utilisateur et un mot de passe temporaire. Dans les paramètres de l’utilisateur, la section « Accès » liste toutes les bibliothèques disponibles : cochez uniquement celles auxquelles cet utilisateur doit avoir accès. Sauvegardez. L’utilisateur verra désormais uniquement ces bibliothèques quand il se connecte.

Pour une organisation avec plusieurs niveaux d’accès, la convention de nommage des bibliothèques fait toute la différence. Voici un exemple de structure adaptée à une PME :

/mnt/medias/
├── formations-socle/        # accessible à tous les employés
├── formations-management/   # accessible aux managers uniquement
├── archives-conferences/    # accessible à l'équipe direction
├── tutos-it-internes/       # accessible à l'équipe technique
└── onboarding/             # accessible aux nouveaux arrivants pendant 90 jours

Chaque dossier correspond à une bibliothèque Jellyfin distincte. La granularité est au niveau de la bibliothèque entière, pas du fichier individuel — si vous avez besoin d’un contrôle plus fin, la solution est de multiplier les bibliothèques ou d’utiliser le plugin LDAP pour synchroniser les groupes Active Directory avec les accès Jellyfin.

Un détail important : Jellyfin ne gère pas nativement les invitations par lien. La création des comptes est manuelle ou via l’API REST (endpoint POST /Users/New). Pour des déploiements de plus de 50 utilisateurs, envisager l’automatisation via un script Python qui lit un fichier CSV RH et crée les comptes en masse via l’API Jellyfin.

Étape 5 — Transcodage hardware (Intel Quick Sync ou NVENC)

Le transcodage vidéo est l’opération la plus coûteuse en ressources CPU dans Jellyfin. Chaque fois qu’un client ne supporte pas nativement le format de la vidéo source (codec, résolution, bitrate), Jellyfin doit re-encoder la vidéo à la volée. Sur un CX22 avec uniquement les vCPU, un flux 1080p H.264 consomme environ 80 à 100 % d’un cœur — ce qui limite sérieusement le nombre de lectures simultanées possibles.

La documentation officielle Jellyfin (jellyfin.org/docs/general/administration/hardware-acceleration/) documente plusieurs solutions d’accélération matérielle. Les deux les plus pertinentes selon votre infrastructure sont Intel Quick Sync (disponible sur les processeurs Intel Core/Xeon avec iGPU intégré, typiquement les serveurs dédiés OVH ou les machines on-premise) et NVIDIA NVENC (cartes RTX/GTX, serveurs dédiés GPU).

Pour activer l’accélération Intel Quick Sync sur un serveur dédié Ubuntu 22.04 :

# Vérifier que le device Intel Media est disponible
ls /dev/dri/
# Doit afficher renderD128 ou card0

# Installer les drivers intel-media-va-driver
apt install -y intel-media-va-driver-non-free vainfo

# Vérifier que VA-API fonctionne
vainfo
# Doit lister les profils H264VAEncMain, HEVC, etc.

Ensuite, dans le docker-compose.yml, exposez le device GPU au conteneur en ajoutant :

    devices:
      - /dev/dri:/dev/dri    # expose l'Intel iGPU au conteneur
    group_add:
      - "109"                # GID du groupe 'render' sur Ubuntu (vérifier avec: getent group render)

Dans l’interface Jellyfin (Tableau de bord → Lecture → Transcodage), sélectionnez « Intel QuickSync (QSV) » ou « VAAPI » dans la liste déroulante et cochez les codecs souhaités (H.264, H.265/HEVC, AV1 si supporté). Après sauvegarde, rechargez le tableau de bord et observez dans les statistiques de lecture que le transcodage utilise désormais le GPU — la charge CPU devrait chuter de 80 % à moins de 15 % par flux.

Pour les VPS Hetzner cloud (CX22, CPX), aucun GPU n’est disponible. La stratégie recommandée dans ce cas est de normaliser les formats sources avant de les uploader : convertir toutes les vidéos en H.264 1080p 4 Mbps avec ffmpeg avant dépôt, de sorte que les clients modernes lisent en direct play sans transcodage. Cela réduit drastiquement la charge CPU du serveur.

Étape 6 — Clients web et mobile

L’un des atouts majeurs de Jellyfin pour un déploiement entreprise est la richesse de son écosystème client. Les employés n’ont pas besoin d’installer de logiciel particulier pour accéder aux formations : l’interface web intégrée fonctionne dans tout navigateur moderne (Chrome, Firefox, Edge, Safari) et supporte la lecture directe ainsi que le transcodage adaptatif.

L’interface web est accessible à l’adresse de votre serveur (https://media.monentreprise.com) et ne requiert qu’un identifiant/mot de passe. Elle est responsive et fonctionne correctement sur mobile, même si l’expérience sur petit écran est inférieure aux applications natives. Pour les tablettes utilisées en salle de formation, l’interface web est largement suffisante.

Pour les équipes terrain qui consultent les formations depuis un smartphone Android, l’application officielle Jellyfin for Android est disponible sur Google Play et sur F-Droid (dépôt open-source sans tracker). Elle supporte le téléchargement hors-ligne des vidéos, ce qui est précieux dans les zones à couverture réseau instable — un employé peut télécharger une formation en WiFi au bureau et la regarder sans connexion sur le terrain. L’application iOS (Swiftfin) est disponible sur l’App Store et couvre les mêmes fonctionnalités essentielles.

Pour les salles de réunion équipées d’un téléviseur connecté, les applications Jellyfin pour Android TV et Amazon Fire TV permettent d’afficher les formations en grand écran sans câble supplémentaire. La configuration est identique : saisir l’URL du serveur et les identifiants. Pour les téléviseurs LG (webOS) ou Samsung (Tizen), des clients tiers comme Jellyfin Media Player ou Jellycon (Kodi add-on) comblent le manque d’applications officielles.

Étape 7 — Sauvegarde des métadonnées

Une erreur fréquente dans les déploiements Jellyfin est de sauvegarder uniquement les fichiers vidéo et d’oublier le dossier de configuration. Or c’est dans ce dossier que résident les informations critiques : la base de données SQLite des utilisateurs (config/data/jellyfin.db), les bibliothèques configurées, les permissions par utilisateur, les préférences de lecture et toutes les métadonnées indexées (miniatures, descriptions, fichiers NFO traités).

La stratégie de sauvegarde recommandée se compose de deux niveaux. Le premier est une sauvegarde quotidienne du répertoire de configuration avec Restic ou rclone vers un bucket de stockage objet (Hetzner Object Storage à 0,01 €/Go, ou un Minio self-hosted) :

#!/bin/bash
# /opt/scripts/backup-jellyfin.sh — à planifier via cron quotidien

# Arrêter proprement le conteneur pour avoir une snapshot cohérente
docker compose -f /opt/jellyfin/docker-compose.yml stop jellyfin

# Sauvegarder config + cache metadata vers bucket
restic -r s3:s3.hetzner.com/mon-bucket/jellyfin backup /opt/jellyfin/config \
  --exclude="/opt/jellyfin/cache/transcodes"   # exclure les transcodes temporaires

# Redémarrer
docker compose -f /opt/jellyfin/docker-compose.yml start jellyfin

echo "[$(date -Iseconds)] Backup Jellyfin OK" >> /var/log/backup-jellyfin.log

Le second niveau est la sauvegarde des fichiers sources (les vidéos elles-mêmes). Compte tenu du volume potentiellement important, une stratégie incrémentale avec Restic ou BorgBackup est préférable à une copie complète chaque nuit. La rétention recommandée est de conserver les 7 derniers quotidiens, 4 hebdomadaires et 6 mensuels — cela couvre la grande majorité des scénarios de récupération sans exploser le budget stockage.

Testez la restauration une fois par trimestre. Une sauvegarde non testée est une sauvegarde dont on ne connaît pas la fiabilité.

Erreurs fréquentes

Adaptation au contexte ouest-africain

Le déploiement de Jellyfin dans une PME ouest-africaine soulève des enjeux spécifiques qui ne figurent pas dans la documentation officielle, mais qui sont déterminants pour l’adoption réelle de l’outil.

Archives OHADA et conformité réglementaire. De nombreuses entreprises de la zone UEMOA organisent des sessions annuelles de formation sur le droit des affaires OHADA, les procédures douanières, la fiscalité locale ou les normes comptables. Ces sessions sont filmées et les enregistrements constituent un patrimoine documentaire précieux. Les stocker sur Google Drive ou YouTube privatisé présente un risque : en cas de suspension de compte, fermeture de service ou décision de l’opérateur, les archives disparaissent. Jellyfin hébergé sur Hetzner (serveurs en Allemagne, soumis au RGPD européen) avec une sauvegarde sur Hetzner Object Storage offre une garantie de pérennité bien supérieure, tout en maintenant un coût prévisible.

Accès via VPN pour les équipes terrain. En Côte d’Ivoire, au Sénégal ou au Mali, les entreprises disposant d’équipes commerciales ou techniques en déplacement ont besoin de leur donner accès aux formations sans exposer le serveur Jellyfin publiquement sur Internet. La solution recommandée est de coupler Jellyfin avec un VPN WireGuard (tutoriel frère disponible dans ce cluster) : les équipes terrain se connectent via WireGuard, accèdent à Jellyfin sur le réseau privé, et le serveur n’est jamais exposé directement. Cela réduit la surface d’attaque et permet de limiter l’accès aux seuls appareils approuvés par l’IT.

Économie du coût des abonnements. Dans le contexte ouest-africain, les abonnements en devise étrangère (YouTube Premium, Vimeo Pro, Wistia) représentent des coûts significatifs une fois convertis en FCFA et soumis aux frais de change. Jellyfin, une fois le VPS Hetzner CX22 payé (~4,35 €/mois), ne génère aucun coût supplémentaire quelle que soit la quantité de vidéos ou le nombre d’utilisateurs. Pour une PME de 50 personnes, l’économie comparée à une solution cloud dédiée vidéo peut dépasser 200 000 FCFA par an.

Conformité ARTCI et protection des données employés. La loi ivoirienne n°2013-450 relative à la protection des données à caractère personnel (ARTCI) et la loi sénégalaise n°2008-12 (CDP) encadrent le traitement des données des salariés. Filmer des formations et stocker des statistiques de visionnage (qui a regardé quoi, combien de temps) constitue un traitement de données personnelles. Avec Jellyfin en mode local, ces données ne quittent pas votre infrastructure. Il est néanmoins recommandé de mentionner dans le règlement intérieur ou le contrat de travail l’existence de ce système de suivi de formations, et de limiter les statistiques collectées à ce qui est strictement nécessaire au suivi pédagogique.

Instabilité électrique et UPS. Sur les sites on-premise (bureau à Abidjan, Dakar ou Bamako), les coupures électriques fréquentes peuvent corrompre la base de données SQLite de Jellyfin si une écriture est interrompue. Sur VPS Hetzner, ce risque est inexistant. Pour un déploiement on-premise, brancher impérativement le serveur sur un onduleur (UPS) et configurer un arrêt propre automatique via l’agent NUT si la batterie descend sous 20 %.

Tutoriels frères

• PeerTube self-hosted pour PME — diffusion de formations en direct et VOD avec contrôle des accès — alternative à Jellyfin axée sur la diffusion et le partage communautaire
• Immich : gestion des photos et documents visuels d’entreprise en self-hosted — pour les archives photographiques d’événements et conférences
• WireGuard VPN pour équipes terrain en Afrique de l’Ouest — sécuriser l’accès à Jellyfin depuis le terrain

Pour aller plus loin

• Retour au pilier : Plateforme médias self-hosted PME francophone : Jellyfin, PeerTube, Immich (2026)
• Documentation officielle Jellyfin : jellyfin.org/docs — référence complète sur l’installation, les plugins, l’API REST et l’accélération hardware
• Code source et issues : github.com/jellyfin/jellyfin — pour contribuer ou suivre les évolutions
• Forum communautaire : forum.jellyfin.org — support communautaire actif (en anglais)
• Prochaine étape suggérée : après avoir déployé Jellyfin, configurez PeerTube dans le même cluster pour disposer d’une plateforme de diffusion en direct pour vos webinaires internes.

FAQ