Configuration Plex Media Server¶
Vue d'ensemble¶
Plex Media Server est installé sur ProbatioVault-IA-Server pour streamer vos médias (films, séries, musique) depuis le NAS Synology DS3617.
Architecture¶
┌─────────────────────────────────┐
│ Synology DS3617 (192.168.1.10) │
│ Share: /home │
│ ├── Films/ │
│ ├── Séries/ │
│ └── Vidéos/ │
└─────────────────────────────────┘
│ SMB/CIFS
↓
┌─────────────────────────────────┐
│ ProbatioVault-IA-Server │
│ (192.168.1.82) │
│ │
│ Mount: /mnt/nas/plex │
│ Plex Data: /data/plex │
│ Port: 32400 │
└─────────────────────────────────┘
Installation automatique¶
Le playbook Ansible install-plex.yml déploie automatiquement Plex via GitLab CI/CD.
Commande manuelle (pour tests locaux) :
ssh ProbatioVault-IA-Server
cd /opt/probatiovault-ia-server
ansible-playbook -i ansible/inventory/hosts ansible/playbooks/install-plex.yml \
--vault-password-file /path/to/vault-pass
Configuration post-installation¶
1. Premier accès¶
- Ouvrir : http://192.168.1.82:32400/web
- Se connecter avec un compte Plex (gratuit sur https://www.plex.tv/)
- Suivre l'assistant de configuration
2. Ajouter les bibliothèques¶
Films : 1. Settings → Libraries → Add Library 2. Type : Movies 3. Folder : /mnt/nas/plex/Films 4. Language : French 5. Lancer le scan initial
Séries : 1. Settings → Libraries → Add Library 2. Type : TV Shows 3. Folder : /mnt/nas/plex/Séries 4. Language : French 5. Lancer le scan initial
Vidéos personnelles : 1. Settings → Libraries → Add Library 2. Type : Home Videos 3. Folder : /mnt/nas/plex/Vidéos
3. Configuration du transcoding¶
Activer le transcoding GPU (RTX 5090) :
- Settings → Transcoder
- Use hardware acceleration when available : Enabled
- Use hardware-accelerated video encoding : Enabled
- Maximum simultaneous video transcode : 6
Le serveur dispose de 2× RTX 5090 (64 GB VRAM), ce qui permet de transcoder jusqu'à 6 flux 4K simultanément.
4. Activer l'accès distant (optionnel)¶
- Settings → Remote Access
- Enable Remote Access
- Manually specify public port : 32400
- Configurer le port forwarding sur votre routeur
Montage NAS¶
Le montage NAS est configuré via Ansible :
Configuration (ansible/playbooks/install-plex.yml) : - Serveur : 192.168.1.10 (Synology DS3617) - Share : home (home directory de l'utilisateur plex) - Point de montage : /mnt/nas/plex - Type : CIFS (SMB) - Credentials : Chiffrés dans ansible/vault.yml
Vérifier le montage :
ssh ProbatioVault-IA-Server
mount | grep plex
# Doit afficher : //192.168.1.10/home on /mnt/nas/plex type cifs (...)
ls /mnt/nas/plex/
# Doit afficher : Films Séries Vidéos
Remonter manuellement (en cas de problème) :
ssh ProbatioVault-IA-Server
sudo umount /mnt/nas/plex
sudo mount -t cifs //192.168.1.10/home /mnt/nas/plex \
-o username=plex,password=CV8edmJ1HrzrL56,uid=998,gid=998
Gestion du service¶
Commandes systemd :
# Statut
systemctl status plexmediaserver
# Démarrer
sudo systemctl start plexmediaserver
# Arrêter
sudo systemctl stop plexmediaserver
# Redémarrer
sudo systemctl restart plexmediaserver
# Logs
sudo journalctl -u plexmediaserver -f
Vérifier l'accès :
Organisation des médias sur le NAS¶
Structure recommandée :
/mnt/nas/plex/
├── Films/
│ ├── Avatar (2009).mkv
│ ├── Inception (2010).mkv
│ └── ...
├── Séries/
│ ├── Breaking Bad/
│ │ ├── Season 01/
│ │ │ ├── Breaking Bad - S01E01 - Pilot.mkv
│ │ │ └── ...
│ │ └── Season 02/
│ └── ...
└── Vidéos/
├── Vacances 2023.mp4
└── ...
Conventions de nommage : - Films : Titre (Année).ext - Séries : Série - S01E01 - Titre.ext
Voir : https://support.plex.tv/articles/naming-and-organizing-your-movie-media-files/
Permissions¶
Utilisateur Plex : - UID : 998 - GID : 998 - Home : /var/lib/plexmediaserver
Permissions NAS : - Le montage SMB utilise uid=998,gid=998 - L'utilisateur plex a accès en lecture aux médias
Vérifier les permissions :
Troubleshooting¶
Plex ne voit pas les médias¶
Vérifier le montage :
Si vide → remonter le NAS (voir section "Montage NAS")
Le transcoding ne fonctionne pas¶
Vérifier que les pilotes NVIDIA sont installés :
Vérifier les logs Plex :
Plex ne démarre pas¶
Vérifier les logs :
Réinstaller :
# Via GitLab CI/CD (recommandé)
# Relancer le job ansible:install-plex
# Ou manuellement
cd /opt/probatiovault-ia-server
ansible-playbook -i ansible/inventory/hosts ansible/playbooks/install-plex.yml
Erreur "Permission denied" sur le montage NAS¶
Vérifier les credentials :
# Tester le montage manuellement
sudo mount -t cifs //192.168.1.10/home /tmp/test \
-o username=plex,password=CV8edmJ1HrzrL56
ls /tmp/test
sudo umount /tmp/test
Si ça échoue → vérifier les permissions du share sur le NAS Synology.
Maintenance¶
Scanner manuellement les bibliothèques¶
Via l'interface web : 1. Settings → Libraries 2. Cliquer sur les 3 points → "Scan Library Files"
Via CLI :
ssh ProbatioVault-IA-Server
sudo -u plex /usr/lib/plexmediaserver/Plex\ Media\ Scanner --scan --refresh --section 1
# Section 1 = Films (vérifier l'ID dans l'interface)
Nettoyer le cache¶
ssh ProbatioVault-IA-Server
sudo systemctl stop plexmediaserver
sudo rm -rf /var/lib/plexmediaserver/Library/Application\ Support/Plex\ Media\ Server/Cache/*
sudo systemctl start plexmediaserver
Sauvegarder les métadonnées¶
Les métadonnées Plex sont stockées dans : /data/plex/
# Backup
ssh ProbatioVault-IA-Server
sudo tar -czf /tmp/plex-metadata-$(date +%Y%m%d).tar.gz /data/plex/
# Restore
sudo systemctl stop plexmediaserver
sudo tar -xzf /tmp/plex-metadata-20260211.tar.gz -C /
sudo systemctl start plexmediaserver
Clients Plex¶
Applications disponibles : - Web : http://192.168.1.82:32400/web - Desktop : https://www.plex.tv/media-server-downloads/#plex-app - Mobile : iOS, Android (Plex app) - TV : Smart TV, Apple TV, Chromecast, Fire TV
Accès direct (sans compte Plex) : - URL : http://192.168.1.82:32400/web - Mode invité : Activé dans Settings → Users → Guest Access
Ressources¶
- Documentation officielle : https://support.plex.tv/
- Conventions de nommage : https://support.plex.tv/articles/naming-and-organizing-your-movie-media-files/
- Agents de métadonnées : https://support.plex.tv/articles/200241558-agents/
- Transcoding : https://support.plex.tv/articles/200250377-transcoding-media/
Résumé¶
✅ Plex installé et configuré ✅ NAS monté : /mnt/nas/plex (192.168.1.10/home) ✅ Transcoding GPU : 2× RTX 5090 (jusqu'à 6 flux 4K simultanés) ✅ Accès web : http://192.168.1.82:32400/web ✅ Métadonnées : Stockées localement dans /data/plex
Point d'entrée : http://192.168.1.82:8080 (Homer Dashboard) → Plex Media Server