TroubleshootingDépannage

First, read the logsD’abord, lire les journaux

Tentacle writes what it does — and why it refuses something — in its log. Passwords and keys are hidden there.Tentacle écrit ce qu’il fait — et pourquoi il refuse quelque chose — dans son journal. Les mots de passe et les clés y sont masqués.

docker compose logs --tail 200 tentacle     # from the stack's folder
docker logs --tail 200 <container>         # any container, by name or ID

docker compose logs --tail 200 tentacle     # depuis le dossier de la pile
docker logs --tail 200 <conteneur>         # tout conteneur, par son nom ou son identifiant

Portainer: Containers › the Tentacle container › Logs. NAS: the container’s “Log” page. Then Jellyfin’s log, the same way.Portainer : Containers › le conteneur Tentacle › Logs. NAS : la page « Journal » du conteneur. Puis celui de Jellyfin, de la même façon.

I cannot find the setup codeJe ne trouve pas le code d’installation

• It is in the log of the Tentacle container (not Jellyfin’s), in a block framed with ═══.Il est dans le journal du conteneur Tentacle (pas celui de Jellyfin), dans un bloc encadré de ═══.
• The log was cleared or the code was used: ask for a new one with tentacle setup token in the container’s console (docker exec <container> tentacle setup token).Le journal a été vidé ou le code a servi : demandez-en un neuf avec tentacle setup token dans la console du conteneur (docker exec <conteneur> tentacle setup token).
• It is also in data/setup-token.txt of the data volume.Il est aussi dans data/setup-token.txt du volume de données.
• No block at all? The setup is already finished: see “Open the wizard again” below.Aucun bloc ? L’installation est déjà finie : voir « Rouvrir l’assistant » plus bas.

All the ways to read it: the setup code.Toutes les façons de le lire : le code d’installation.

I chose the wrong JellyfinJ’ai choisi le mauvais Jellyfin

During the setup: go Back to the Jellyfin screen and pick the other one. What had been prepared for the first is forgotten (an account already created on it stays there).Pendant l’installation : revenez (Retour) à l’écran Jellyfin et choisissez l’autre. Ce qui avait été préparé pour le premier est oublié (un compte déjà créé dessus y reste).

After the setup: open the wizard again (below) — it also forgets the choice — or change Jellyfin’s address in Administration › Services › Jellyfin.Après l’installation : rouvrez l’assistant (plus bas) — il oublie aussi le choix — ou changez l’adresse de Jellyfin dans Administration › Services › Jellyfin.

My username or password is refusedMon nom d’utilisateur ou mon mot de passe est refusé

• Tentacle uses Jellyfin’s accounts: test the same name and password on Jellyfin’s own page (http://<machine>:8096).Tentacle utilise les comptes de Jellyfin : essayez le même nom et le même mot de passe sur la page de Jellyfin (http://<machine>:8096).
• Names are case-sensitive.Les noms sont sensibles aux majuscules.
• “This account is not a Jellyfin administrator”: use an administrator account (Jellyfin › Dashboard › Users).« Ce compte n’est pas administrateur de Jellyfin » : utilisez un compte administrateur (Jellyfin › Tableau de bord › Utilisateurs).
• Forgotten administrator password: Jellyfin’s “Forgot password” link, from a device of your home network, then follow its instructions.Mot de passe administrateur oublié : le lien « Mot de passe oublié » de Jellyfin, depuis un appareil du réseau de la maison, puis suivez ses instructions.

The ports stay closedLes ports restent fermés

1. “Access from outside” is on, in Administration › Remote access.« Accès depuis l’extérieur » est allumé, dans Administration › Accès à distance.
2. The router rule points to the server’s current address — reserve it (DHCP reservation).La règle de la box vise l’adresse actuelle du serveur — réservez-la (réservation DHCP).
3. External and internal ports match the table of the wizard (3000 → 3000).Ports externe et interne conformes au tableau de l’assistant (3000 → 3000).
4. No firewall on the server blocks the port (ufw allow 3000/tcp on Ubuntu).Aucun pare-feu du serveur ne bloque le port (ufw allow 3000/tcp sous Ubuntu).
5. Not a shared address: CGNAT.Pas une adresse partagée : CGNAT.
6. Test from a phone on 4G, Wi-Fi off — not from home.Testez depuis un téléphone en 4G, Wi-Fi coupé — pas depuis la maison.

Docker Desktop (Mac, Windows) and colima: everything looks “local” and the real visitors’ addresses are lost. For access from the Internet, prefer Linux or a NAS.Docker Desktop (Mac, Windows) et colima : tout paraît « local » et la vraie adresse des visiteurs est perdue. Pour l’accès depuis Internet, préférez Linux ou un NAS.

Videos are converted instead of played directlyLes vidéos sont converties au lieu d’être lues directement

• At home, apps play directly from Jellyfin through “the Jellyfin address for the apps” (set in the summary). If it says localhost or a wrong address, fix it in Administration › Services › Jellyfin.À la maison, les applications lisent directement chez Jellyfin par « l’adresse de Jellyfin pour les applications » (réglée au récapitulatif). Si elle dit localhost ou une mauvaise adresse, corrigez-la dans Administration › Services › Jellyfin.
• Administration › Overview recommends “direct play” when it is off.Administration › Vue d’ensemble recommande la « lecture directe » quand elle est coupée.
• Away from home, videos go through Tentacle unless direct play from outside is on.Hors de la maison, les vidéos passent par Tentacle sauf si la lecture directe depuis l’extérieur est allumée.
• Some files must be converted for some devices (a codec the TV does not read). The player says so.Certains fichiers doivent être convertis pour certains appareils (un codec que la TV ne lit pas). Le lecteur le dit.

Update the serverMettre à jour le serveur

Settings, accounts and libraries stay. If you pinned TENTACLE_VERSION in .env, change it first.Réglages, comptes et bibliothèques restent. Si vous avez figé TENTACLE_VERSION dans .env, changez-la d’abord.

“Server to update” in an app means the server is older than the app: update it the same way.« Serveur à mettre à jour » dans une application veut dire que le serveur est plus ancien que l’application : mettez-le à jour de la même façon.

After the update to 1.25: the database migrationAprès la mise à jour vers la 1.25 : la migration de la base

Since 1.25, Tentacle keeps its data in one SQLite file. An installation that used MariaDB is copied into it by itself, at the first start. MariaDB is only read, never modified. Everything: Migrating to SQLite.Depuis la 1.25, Tentacle garde ses données dans un fichier SQLite. Une installation qui utilisait MariaDB y est recopiée d’elle-même, au premier démarrage. MariaDB n’est que lue, jamais modifiée. Tout le détail : Migration vers SQLite.

Open the wizard again: tentacle setup resetRouvrir l’assistant : tentacle setup reset

Once finished, the wizard closes for good — nobody can reopen it from a browser. Only the machine can: type tentacle setup reset in the container’s console (Portainer: Console › Connect), restart the container, and read the new code in its log.Une fois finie, l’assistant se ferme pour de bon — personne ne peut le rouvrir depuis un navigateur. Seule la machine le peut : tapez tentacle setup reset dans la console du conteneur (Portainer : Console › Connect), redémarrez le conteneur, et lisez le nouveau code dans son journal.

docker exec <container> tentacle setup reset
docker restart <container>
docker logs <container>      # the new setup code

docker exec <conteneur> tentacle setup reset
docker restart <conteneur>
docker logs <conteneur>      # le nouveau code d’installation

Your settings, your accounts and the libraries stay. The choice of Jellyfin is forgotten: you choose it again, and sign in again.Vos réglages, vos comptes et les bibliothèques restent. Le choix du Jellyfin est oublié : vous le refaites, et vous vous reconnectez.

Messages of the wizardLes messages de l’assistant