Attention Oulim Player NAS n’est pas encore sorti : il n’est donc pas encore possible de l’installer. L’image sera publiée en même temps que l’app — vous pourrez alors suivre ce guide.
Attention Il s’agit d’une version bêta. Nous la testons encore sur différents modèles de NAS : des problèmes inattendus peuvent survenir. En cas de souci, utilisez Signaler un problème en bas à gauche de la page d’administration. Le journal du serveur NAS est joint au signalement, ce qui aide à trouver la cause (adresses et chemins masqués).
Ce qu’il vous faut
- Un NAS compatible Docker (conteneurs) : Container Manager sur Synology, Container Station sur QNAP, ou une machine Linux avec Docker installé
- Un processeur 64 bits : Intel/AMD (x64) ou ARM64. Les NAS ARM 32 bits ne sont pas pris en charge
- Au moins 1 Go de mémoire libre (2 Go ou plus recommandés)
- Un téléphone, une tablette ou une TV sur le même Wi-Fi, avec Oulim Player installé
Astuce Si vous avez un PC toujours allumé, vous pouvez aussi y installer Oulim Desktop à la place du NAS : il fait la même chose. Consultez le guide « Utiliser votre PC comme NAS ».
1. Préparer le fichier compose
Copiez le texte ci-dessous. Seules les deux lignes marquées <- sont à adapter à votre NAS.
services:
oulim-player:
image: <published at app launch>
container_name: oulim-player
network_mode: host
user: "1000:1000" # <- your NAS user id (id -u : id -g)
environment:
- OULIM_NAME=Oulim NAS
- OULIM_MEDIA=/volume1 # folders you can add in the admin page (several: /volume1:/volume2)
volumes:
- ./config:/config
- ./cache:/cache
- /volume1:/volume1:ro # <- your video storage, read-only
restart: unless-stopped| Ligne | Que saisir |
|---|---|
| user | L’identifiant de votre utilisateur sur le NAS. Connectez-vous au NAS en SSH et tapez id : vous verrez quelque chose comme uid=1026(…) gid=100(…). Saisissez ces nombres, par exemple "1026:100" |
| /volume1:/volume1:ro | Le dossier racine du stockage qui contient vos vidéos. Indiquez le même chemin du NAS des deux côtés. :ro signifie lecture seule : Oulim ne peut ni supprimer ni modifier vos vidéos |
| OULIM_MEDIA | L’emplacement où choisir les dossiers de la bibliothèque dans la page d’administration. Indiquez le même chemin que celui monté plus haut |
| OULIM_NAME | Le nom affiché sur le téléphone et la TV (vous pouvez le laisser tel quel) |
| NAS | Exemples de chemins de stockage |
|---|---|
| Synology | /volume1 · /volume2 … (disques USB : /volumeUSB1/usbshare) |
| QNAP | /share/CACHEDEV1_DATA · /share/CACHEDEV2_DATA … |
| Autre Linux | L’endroit où le disque de vidéos est monté (par ex. /mnt/media) |
Astuce Plusieurs volumes de stockage ? Ajoutez une ligne sous volumes pour chacun et reliez-les dans OULIM_MEDIA avec :, par exemple OULIM_MEDIA=/volume1:/volume2
Attention Ne montez pas tout le NAS (/) : les dossiers système apparaîtraient aussi. Montez uniquement le stockage qui contient vos vidéos.
2. Lancer le conteneur
Créez sur le NAS un dossier où Oulim enregistrera ses réglages (par exemple docker/oulim). Lorsque vous lancez compose depuis ce dossier, les dossiers config et cache y sont créés.
| NAS | Comment lancer |
|---|---|
| Synology | Container Manager › Project › Create → choisissez le dossier comme chemin → collez le texte copié dans Create docker-compose.yml → Done |
| QNAP | Container Station › Applications › Create → collez le texte copié en YAML → Create |
| Autre Linux | Enregistrez-le sous compose.yaml dans le dossier et lancez docker compose up -d |
- Guide Synology : Container Manager › Projet ↗
- Guide QNAP : Utiliser Container Station 3 ↗
- Linux : Installer Docker Engine ↗ · Installer Docker Compose ↗
Astuce Les noms des menus du NAS peuvent varier légèrement selon la version de DSM ou de QTS et selon la langue. Les guides officiels ci-dessus montrent les écrans.
3. Première configuration
- Sur un PC connecté au même Wi-Fi, ouvrez
http://adresse-du-NAS:45800dans un navigateur. L’écran Première configuration s’affiche. - Repérez le Code de configuration dans le journal du conteneur : sur Synology, dans Container Manager › Container › oulim-player › Log ; sous Linux, avec
docker logs oulim-player. - Saisissez le code de configuration, choisissez un mot de passe administrateur (8 caractères minimum) et sélectionnez Commencer.

Astuce La page d’administration ne s’ouvre que depuis votre réseau domestique. Le mot de passe est enregistré uniquement sur ce NAS.
4. Ajouter les dossiers de la bibliothèque
- Dans l’onglet Bibliothèque, sélectionnez Ajouter un dossier.
- Si vous avez plusieurs volumes, choisissez-en un en haut, ouvrez votre dossier de vidéos et sélectionnez Ajouter ce dossier.
- Le classement commence aussitôt. Affiches et résumés apparaissent au fur et à mesure que chaque titre est traité.

Les conseils pour nommer vos dossiers sont les mêmes que dans le guide « Organiser vos fichiers et dossiers ». Quand vous ajoutez ou supprimez des vidéos dans le dossier, Oulim en tient compte tout seul.
5. Ajouter votre téléphone, tablette ou TV
- Page d’administration : dans l’onglet Appareils, sélectionnez Ajouter un appareil. Un QR code et un Code d’association s’affichent.
- Téléphone : dans l’onglet Réseau, touchez l’icône QR en haut (Ajouter mon PC) et scannez le QR code. Sur une TV, saisissez le code d’association sur ce même écran.
- Page d’administration : quand la demande arrive, vérifiez que le code de confirmation est identique sur les deux écrans, puis sélectionnez Approuver.

Le NAS apparaît dans l’onglet Réseau de l’appareil ajouté, et ses vidéos s’affichent dans Accueil et Médiathèque.
Astuce Si vous utilisez aussi Oulim Desktop sur un PC, n’ajoutez pas en plus ce dossier du NAS à la bibliothèque du PC via SMB. Pour regarder sur le PC, enregistrez le PC auprès de ce NAS comme un téléphone. S’il est déjà ajouté, le PC ne relaie pas ce dossier vers vos appareils — pour éviter les vidéos en double.
Regarder hors de chez vous (Pro)
Choisissez le mode de connexion dans l’onglet Accès à distance de la page d’administration. Si votre box ou votre routeur prend en charge l’ouverture automatique des ports (UPnP), Oulim ouvre le port pour vous. Plus de détails dans le guide « NAS et connexion réseau ».
Astuce L’accès à distance est désactivé au départ (réseau domestique uniquement). Même activé, seul le port utilisé par vos appareils est ouvert sur le routeur — la page d’administration n’est jamais ouverte sur internet.
Astuce Si vous utilisez à la fois un NAS et un PC avec Oulim Desktop, chacun doit avoir son propre port externe sur le routeur. En ouverture automatique, Oulim choisit un numéro libre (45810 · 45811 …). Si vous redirigez les ports vous-même sur le routeur, utilisez le Port externe indiqué dans l’onglet Accès à distance : par exemple PC 45810 et NAS 45811.
Mettre à jour et arrêter
- Pour mettre à jour, récupérez la nouvelle image et relancez. Sur Synology, faites Stop → Build (récupère l’image) → Start sur le projet ; sous Linux, lancez
docker compose pullpuisdocker compose up -d. - Les réglages, les appareils enregistrés et la bibliothèque classée restent dans le dossier
config: rien n’est perdu lors d’une mise à jour. - Oulim se relance tout seul quand le NAS redémarre, sauf si vous l’avez arrêté vous-même : il reste alors éteint.
Transcodage matériel (facultatif)
Un NAS doté d’une puce graphique intégrée Intel (Quick Sync) ou AMD peut convertir les vidéos 4K en 1080p pendant la diffusion. Oulim vérifie si c’est possible à chaque démarrage : consultez la ligne du transcodage dans État, sur la page d’administration.
Mais par défaut, Docker ne donne pas au conteneur l’accès à la puce graphique du NAS. Pour l’autoriser, ajoutez les deux lignes ci-dessous au-dessus de la ligne restart dans compose. Sur un NAS sans puce graphique, ces lignes empêchent le conteneur de démarrer : supprimez-les alors, et les vidéos seront lues telles quelles.
devices:
- /dev/dri:/dev/driDépannage
| Problème | À vérifier |
|---|---|
| Mon téléphone ne voit pas le NAS | Que les deux sont sur le même Wi-Fi, que compose contient network_mode: host et que le pare-feu du NAS ne bloque pas l’UDP 45809 ni le TCP/UDP 45810 |
| Le dossier voulu n’apparaît pas dans Ajouter un dossier | Que ce stockage est monté sous volumes dans compose et que le même chemin figure dans OULIM_MEDIA |
| Les vidéos n’apparaissent pas ou ne sont pas classées | Que le compte du NAS peut lire le dossier de vidéos : c’est le compte dont vous avez saisi le numéro dans user du compose. Dans le gestionnaire de fichiers du NAS, ce compte (ou son groupe) doit avoir l’autorisation « lecture » sur le dossier |
| Le conteneur ne démarre plus après l’ajout du transcodage matériel | Le NAS n’a pas de puce graphique (/dev/dri). Supprimez les deux lignes devices et relancez |
| J’ai deux serveurs Oulim NAS sur la même machine et la seconde page d’administration ne s’ouvre pas | Le port de la page d’administration (45800) est déjà pris. Dans le second compose, ajoutez un autre numéro sous environment, par exemple OULIM_ADMIN_PORT=45801, puis ouvrez http://adresse-du-NAS:45801 |
| J’ai perdu le code de configuration | Redémarrez le conteneur : il réapparaît dans le journal (tant que la première configuration n’est pas terminée) |