Questions & answersQuestions-réponses
Short answers to the questions people ask before, during and after the setup.Des réponses courtes aux questions qu’on se pose avant, pendant et après l’installation.
The basicsLes bases
What is the difference between Tentacle and Jellyfin?Quelle différence entre Tentacle et Jellyfin ?
Jellyfin reads your files and streams them. Tentacle TV is a separate program that works with it: accounts and invitations, TV pairing, recommendations, and the same modern app on every screen. It does not replace Jellyfin, which remains free software of its own, developed by the Jellyfin project. Tentacle TV is an independent project, neither affiliated with nor endorsed by the Jellyfin project. You need both; the Tentacle + Jellyfin stack installs the official Jellyfin image next to Tentacle.
Jellyfin lit vos fichiers et les diffuse. Tentacle TV est un programme distinct qui fonctionne avec lui : comptes et invitations, jumelage des TV, recommandations, et la même application moderne sur chaque écran. Il ne remplace pas Jellyfin, qui reste un logiciel libre à part entière, développé par le projet Jellyfin. Tentacle TV est un projet indépendant, ni affilié au projet Jellyfin ni approuvé par lui. Il faut les deux ; la pile Tentacle + Jellyfin installe l’image officielle de Jellyfin à côté de Tentacle.
Do my files go to a cloud?Mes fichiers partent-ils dans un nuage ?
No. Everything stays on your machine. Only public information is fetched from the Internet (posters, summaries, skip timestamps).
Non. Tout reste sur votre machine. Seules des informations publiques sont récupérées sur Internet (affiches, résumés, horodatages des génériques).
Does the machine have to stay on?La machine doit-elle rester allumée ?
While you watch, yes. A NAS or a mini-PC uses little power; it can sleep at night if nobody watches.
Pendant que vous regardez, oui. Un NAS ou un mini-PC consomme peu ; il peut dormir la nuit si personne ne regarde.
How many people can watch at once?Combien de personnes peuvent regarder en même temps ?
As many as your machine and your connection allow. Direct play costs almost nothing; each conversion (transcoding) costs CPU — a GPU helps.
Autant que votre machine et votre connexion le permettent. La lecture directe ne coûte presque rien ; chaque conversion (transcodage) coûte du processeur — un GPU aide.
Where do I find movies?Où trouver des films ?
Your own videos, your digitised DVDs and Blu-rays, and free films (Blender Foundation, public domain). Tentacle does not provide any content.
Vos propres vidéos, vos DVD et Blu-ray numérisés, et des films libres (Blender Foundation, domaine public). Tentacle ne fournit aucun contenu.
InstallingL’installation
Is the setup code a password?Le code d’installation est-il un mot de passe ?
No: it serves once, during the setup. Your password is the administrator account.
Non : il sert une fois, pendant l’installation. Votre mot de passe, c’est le compte administrateur.
Why no code from home?Pourquoi pas de code depuis la maison ?
Like Jellyfin or Plex, your home network is trusted for the first claim. Someone already on your Wi-Fi could claim it first — you would know at once, because your own browser would then be asked for the code. Then tentacle setup reset and start again.
Comme Jellyfin ou Plex, le réseau de la maison est cru pour la première prise. Quelqu’un déjà sur votre Wi-Fi pourrait le réclamer avant vous — vous le sauriez aussitôt, car votre propre navigateur se verrait demander le code. Alors tentacle setup reset et l’on recommence.
Can I install on a Mac or on Windows?Puis-je installer sur un Mac ou sous Windows ?
On Windows, yes, without Docker: the Tentacle Server app of the Microsoft Store, which can also install Jellyfin for you. On a Mac, at home: Jellyfin installed natively (the only way the Jellyfin project supports there), then Tentacle with Docker Desktop and the tentacle-only stack. For access from the Internet, Docker Desktop hides visitors’ addresses: a Linux machine or a NAS is better.
Sous Windows, oui, sans Docker : l’app Tentacle Server du Microsoft Store, qui peut aussi installer Jellyfin pour vous. Sur un Mac, à la maison : Jellyfin installé 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, Docker Desktop cache l’adresse des visiteurs : une machine Linux ou un NAS est préférable.
I already have Jellyfin: which stack?J’ai déjà Jellyfin : quelle pile ?
Take tentacle-only and choose the Jellyfin server in the wizard. tentacle-full also works: it brings a second Jellyfin, which you simply do not pick.
Prenez tentacle-only et choisissez le serveur Jellyfin dans l’assistant. tentacle-full marche aussi : elle apporte un second Jellyfin, que vous ne choisissez simplement pas.
Will Tentacle create accounts in Jellyfin?Tentacle va-t-il créer des comptes dans Jellyfin ?
Not in a Jellyfin already set up: no account, no library. Only its own access key (“Tentacle”). Accounts are created later, when you invite someone.
Pas dans un Jellyfin déjà configuré : ni compte, ni bibliothèque. Seulement sa propre clé d’accès (« Tentacle »). Les comptes se créent plus tard, quand vous invitez quelqu’un.
Do I need to write any password in the compose file?Faut-il écrire un mot de passe dans le fichier compose ?
No. There is no database to set up: Tentacle keeps its data in one file of its volume, tentacle.db.
Non. Il n’y a aucune base à régler : Tentacle garde ses données dans un fichier de son volume, tentacle.db.
Every dayAu quotidien
How do I update?Comment mettre à jour ?
docker compose pull && docker compose up -d, or “Pull and redeploy” in Portainer. All the ways.
docker compose pull && docker compose up -d, ou « Pull and redeploy » dans Portainer. Toutes les façons.
How do I back up?Comment sauvegarder ?
The volumes hold everything: tentacle-data (with the database, tentacle.db), and jellyfin-config for the Tentacle + Jellyfin stack (jellyfin-cache is only a cache). Copy them while the stack is stopped — see The database. Back up your media folder separately.
Les volumes portent tout : tentacle-data (avec la base, tentacle.db), et jellyfin-config pour la pile Tentacle + Jellyfin (jellyfin-cache n’est qu’un cache). Copiez-les pile arrêtée — voir La base de données. Sauvegardez votre dossier des médias à part.
How do I add someone from my family?Comment ajouter quelqu’un de ma famille ?
Administration › Invitations: create an invitation and send it. The person creates their own account with it.
Administration › Invitations : créez une invitation et envoyez-la. La personne crée son propre compte avec.
Can I move the server to another machine?Puis-je déplacer le serveur sur une autre machine ?
Yes: stop the stack, copy its folder and its volumes, start it on the new machine. The server finds its installed database and keeps the wizard closed.
Oui : arrêtez la pile, copiez son dossier et ses volumes, démarrez-la sur la nouvelle machine. Le serveur trouve sa base installée et garde l’assistant fermé.
I used the old docker-compose.yml: must I migrate?J’utilisais l’ancien docker-compose.yml : faut-il migrer ?
No, it keeps working with the new image: at the update to 1.25, its MariaDB is copied into SQLite by itself. Then you can drop MariaDB, or move to a new stack — see Migrating to SQLite.
Non, il continue de marcher avec la nouvelle image : à la mise à jour vers la 1.25, sa MariaDB est recopiée d’elle-même dans SQLite. Ensuite, vous pouvez retirer MariaDB, ou passer à une pile neuve — voir Migration vers SQLite.
Does Tentacle ever control Docker?Tentacle pilote-t-il Docker ?
Never. It does not mount the Docker socket and never runs as root. Updates are your decision: the administration only gives you the command.
Jamais. Il ne monte pas le socket Docker et ne tourne jamais en root. Les mises à jour sont votre décision : l’administration vous donne seulement la commande.