Before you startAvant de commencer
Five minutes of reading to choose a machine, a way to run Docker, and one of the two stacks. Nothing to install yet.Cinq minutes de lecture pour choisir une machine, une façon de faire tourner Docker, et l’une des deux piles. Rien à installer pour l’instant.
A machine that stays onUne machine qui reste allumée
Tentacle and Jellyfin run on one machine of your home, which stays on when you want to watch. Any of these works:Tentacle et Jellyfin tournent sur une machine de la maison, allumée quand vous voulez regarder. Toutes celles-ci conviennent :
| MachineMachine | Good to knowBon à savoir |
|---|---|
| A NAS (Synology, QNAP, Unraid…)Un NAS (Synology, QNAP, Unraid…) | The usual choice: it is always on and already holds your files. It needs Docker (“Container Manager” on Synology).Le choix habituel : il est toujours allumé et porte déjà vos fichiers. Il lui faut Docker (« Container Manager » sur Synology). |
| A Linux computer or mini-PCUn ordinateur ou mini-PC sous Linux | Ideal: Docker runs natively, and remote access works best.Idéal : Docker y tourne nativement, et l’accès à distance y marche le mieux. |
| A Windows PCUn PC Windows | The simplest: the Tentacle Server app of the Microsoft Store — no Docker; the wizard can install Jellyfin for you. It runs while you are signed in to Windows.Le plus simple : l’app Tentacle Server du Microsoft Store — sans Docker ; l’assistant peut installer Jellyfin pour vous. Elle tourne tant que votre session Windows est ouverte. |
| A MacUn Mac | Possible at home: install Jellyfin natively (the only way the Jellyfin project supports there), then Tentacle with Docker Desktop and the tentacle-only stack. For access from the Internet, prefer Linux or a NAS.Possible à la maison : installez Jellyfin en natif (la seule façon que le projet Jellyfin y prend en charge), puis Tentacle avec Docker Desktop et la pile tentacle-only. Pour l’accès depuis Internet, préférez Linux ou un NAS. |
No need for a powerful machine: Jellyfin only works hard when it must convert a video your device cannot read. 4 GB of RAM is comfortable.Pas besoin d’une machine puissante : Jellyfin ne travaille dur que s’il doit convertir une vidéo que votre appareil ne sait pas lire. 4 Go de mémoire suffisent largement.
Docker, in two sentencesDocker, en deux phrases
Docker runs programs in sealed boxes called containers, downloaded ready to use. A compose file (compose.yaml) lists the boxes to start together — Tentacle gives you that file; you never install Tentacle by hand.Docker fait tourner des programmes dans des boîtes étanches appelées conteneurs, téléchargées prêtes à l’emploi. Un fichier compose (compose.yaml) liste les boîtes à démarrer ensemble — Tentacle vous donne ce fichier ; vous n’installez jamais Tentacle à la main.
| You have…Vous avez… | How you will use DockerComment vous utiliserez Docker |
|---|---|
| LinuxLinux | Install Docker Engine with its official guide, then type commands in a terminal.Installez Docker Engine avec son guide officiel, puis tapez les commandes dans un terminal. |
| SynologySynology | Package Center › Container Manager, then “Project” to paste the compose file.Centre de paquets › Container Manager, puis « Projet » pour coller le fichier compose. |
| UnraidUnraid | The Docker tab; for a compose file, the “Docker Compose Manager” plugin, or Portainer.L’onglet Docker ; pour un fichier compose, le greffon « Docker Compose Manager », ou Portainer. |
| PortainerPortainer | Stacks › Add stack, paste the compose file, Deploy the stack.Stacks › Add stack, collez le fichier compose, Deploy the stack. |
| Mac or WindowsMac ou Windows | Docker Desktop, then a terminal.Docker Desktop, puis un terminal. |
docker by podman in every command. Rootless Podman is supported.Remplacez docker par podman dans chaque commande. Podman sans root est pris en charge.Which stack?Quelle pile ?
A stack is one ready-made compose file. There are two; most people take the first. Neither needs a database: Tentacle keeps its data in one file of its volume.Une pile, c’est un fichier compose tout prêt. Il y en a deux ; la plupart des gens prennent la première. Aucune ne demande de base de données : Tentacle garde ses données dans un fichier de son volume.
| StackPile | ContainsContient | Choose it whenÀ choisir quand |
|---|---|---|
| tentacle-full | Tentacle and JellyfinTentacle et Jellyfin | you start from scratch, or want everything in one place (recommended)vous partez de zéro, ou voulez tout au même endroit (conseillée) |
| tentacle-only | Tentacle aloneTentacle seul | Jellyfin already runs elsewhere (NAS app, another container, native install)Jellyfin tourne déjà ailleurs (application du NAS, autre conteneur, installation native) |
The tentacle-full stack is meant for a Linux machine or a NAS. On a Mac, take tentacle-only with a native Jellyfin; on a Windows PC, the Tentacle Server app is simpler.La pile tentacle-full est faite pour une machine Linux ou un NAS. Sur un Mac, prenez tentacle-only avec un Jellyfin installé en natif ; sur un PC Windows, l’app Tentacle Server est plus simple.
Not sure? Take tentacle-full. Already have a Jellyfin with your libraries? You can still take tentacle-full and pick your Jellyfin in the wizard — or take tentacle-only, lighter.Pas sûr ? Prenez tentacle-full. Vous avez déjà un Jellyfin avec vos bibliothèques ? Vous pouvez quand même prendre tentacle-full et choisir votre Jellyfin dans l’assistant — ou prendre tentacle-only, plus légère.
Before 1.25, these stacks also brought MariaDB, and a third one, tentacle-db, existed: Tentacle no longer needs a database server. Already running one of them? See Migrating to SQLite.Avant la 1.25, ces piles apportaient aussi MariaDB, et il en existait une troisième, tentacle-db : Tentacle n’a plus besoin d’un serveur de base de données. Vous en faites déjà tourner une ? Voir Migration vers SQLite.
Where your movies will liveOù vivront vos films
Decide now which folder of the machine will hold your videos — for example /srv/media on Linux, /volume1/media on a Synology, /mnt/user/media on Unraid. Inside, one folder per kind:Décidez maintenant quel dossier de la machine portera vos vidéos — par exemple /srv/media sous Linux, /volume1/media sur un Synology, /mnt/user/media sur Unraid. Dedans, un dossier par genre :
/srv/media
├── films
│ └── Big Buck Bunny (2008)
│ └── Big Buck Bunny (2008).mkv
└── series
└── Pioneer One (2010)
└── Season 01
└── Pioneer One S01E01.mkv/srv/media
├── films
│ └── Big Buck Bunny (2008)
│ └── Big Buck Bunny (2008).mkv
└── series
└── Pioneer One (2010)
└── Season 01
└── Pioneer One S01E01.mkvThe name (year) pattern lets Jellyfin find the poster and the summary. More in Add movies and shows.Le modèle nom (année) permet à Jellyfin de trouver l’affiche et le résumé. Plus de détails dans Ajouter des films et des séries.
Windows without DockerWindows sans Docker
On a Windows PC, Docker is no longer needed: Tentacle Server for Windows, an app of the Microsoft Store, carries the same server. Docker Desktop keeps working too.Sur un PC Windows, Docker n’est plus nécessaire : Tentacle Server pour Windows, une app du Microsoft Store, porte le même serveur. Docker Desktop marche toujours aussi.
Questions you might haveLes questions qu’on se pose
Do I need to know Linux?Faut-il connaître Linux ?
No. You will copy two or three commands from this guide, or click in Portainer or your NAS. Everything else happens in the browser.
Non. Vous copierez deux ou trois commandes depuis ce guide, ou cliquerez dans Portainer ou votre NAS. Tout le reste se passe dans le navigateur.
Does it cost anything?Est-ce payant ?
No. Tentacle and Jellyfin are free. You only need the machine and its electricity.
Non. Tentacle et Jellyfin sont gratuits. Il ne faut que la machine et son électricité.
I already use Jellyfin. Will Tentacle change it?J’utilise déjà Jellyfin. Tentacle va-t-il le modifier ?
Not without asking. With a Jellyfin that is already set up, Tentacle creates no account and no library; it only suggests settings, all optional. See Choose the Jellyfin server.
Pas sans vous demander. Avec un Jellyfin déjà configuré, Tentacle ne crée ni compte ni bibliothèque ; il propose seulement des réglages, tous facultatifs. Voir Choisir le serveur Jellyfin.
Can I keep using the Jellyfin apps?Puis-je continuer d’utiliser les applications Jellyfin ?
Yes. Jellyfin keeps working as before; Tentacle is one more way to watch.
Oui. Jellyfin continue de fonctionner comme avant ; Tentacle est une façon de plus de regarder.
How much disk space?Combien de place sur le disque ?
About 2 GB for the programs, plus your videos. Jellyfin also keeps images and previews (a few hundred MB per thousand titles).
Environ 2 Go pour les programmes, plus vos vidéos. Jellyfin garde aussi des images et des aperçus (quelques centaines de Mo par millier de titres).