Installer Oulim sur un NAS (bêta)

Oulim Player NAS est un serveur Oulim sans écran qui tourne sur votre NAS 24 h/24. Il fait le même travail qu’Oulim Desktop dans « Utiliser votre PC comme NAS » : il classe vos vidéos, trouve affiches et informations, enregistre vos appareils et gère l’accès depuis l’extérieur. Il suffit de coller un fichier compose et de modifier deux lignes.

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.

compose.yaml
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
LigneQue saisir
userL’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:roLe 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_MEDIAL’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_NAMELe nom affiché sur le téléphone et la TV (vous pouvez le laisser tel quel)
NASExemples de chemins de stockage
Synology/volume1 · /volume2 … (disques USB : /volumeUSB1/usbshare)
QNAP/share/CACHEDEV1_DATA · /share/CACHEDEV2_DATA …
Autre LinuxL’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.

NASComment lancer
SynologyContainer Manager › Project › Create → choisissez le dossier comme chemin → collez le texte copié dans Create docker-compose.yml → Done
QNAPContainer Station › Applications › Create → collez le texte copié en YAML → Create
Autre LinuxEnregistrez-le sous compose.yaml dans le dossier et lancez docker compose up -d

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

  1. Sur un PC connecté au même Wi-Fi, ouvrez http://adresse-du-NAS:45800 dans un navigateur. L’écran Première configuration s’affiche.
  2. 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.
  3. Saisissez le code de configuration, choisissez un mot de passe administrateur (8 caractères minimum) et sélectionnez Commencer.
Première configuration : le Code de configuration du journal du conteneur et le mot de passe administrateur
Première configuration : le Code de configuration du journal du conteneur et le mot de passe administrateur

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

  1. Dans l’onglet Bibliothèque, sélectionnez Ajouter un dossier.
  2. Si vous avez plusieurs volumes, choisissez-en un en haut, ouvrez votre dossier de vidéos et sélectionnez Ajouter ce dossier.
  3. Le classement commence aussitôt. Affiches et résumés apparaissent au fur et à mesure que chaque titre est traité.
Ajouter un dossier : choisissez dans le stockage monté dans compose
Ajouter un dossier : choisissez dans le stockage monté dans compose

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

  1. Page d’administration : dans l’onglet Appareils, sélectionnez Ajouter un appareil. Un QR code et un Code d’association s’affichent.
  2. 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.
  3. Page d’administration : quand la demande arrive, vérifiez que le code de confirmation est identique sur les deux écrans, puis sélectionnez Approuver.
Ajouter un appareil : QR et code d’association ; à l’arrivée d’une demande, vérifiez le code puis cliquez sur Approuver
Ajouter un appareil : QR et code d’association ; à l’arrivée d’une demande, vérifiez le code puis cliquez sur 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 pull puis docker 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/dri

Dépannage

ProblèmeÀ vérifier
Mon téléphone ne voit pas le NASQue 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 dossierQue 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éesQue 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érielLe 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 pasLe 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 configurationRedémarrez le conteneur : il réapparaît dans le journal (tant que la première configuration n’est pas terminée)