Open the wizard · the setup codeOuvrir l’assistant · le code d’installation
From home, the wizard opens straight away. From anywhere else, it asks for a one-time code written in the server’s log — here is where to read it, whatever you use.Depuis la maison, l’assistant s’ouvre tout de suite. De partout ailleurs, il demande un code à usage unique écrit dans le journal du serveur — voici où le lire, quel que soit votre outil.
The welcome screenL’écran d’accueil
Open http://<machine>:3000. The wizard greets you: choose its language (French or English), then Start. A note says the page is in HTTP — that is normal at home.Ouvrez http://<machine>:3000. L’assistant vous accueille : choisissez sa langue (français ou anglais), puis Commencer. Une note dit que la page est en HTTP — c’est normal à la maison.


From home: no codeDepuis la maison : pas de code
Like Jellyfin or Plex, the first browser that reaches the server directly from your home network takes the wizard without any code. The welcome screen then says “You are on this server’s network: no code to look for”.Comme Jellyfin ou Plex, le premier navigateur qui joint le serveur directement depuis le réseau de la maison prend l’assistant sans aucun code. L’écran d’accueil dit alors « Vous êtes sur le réseau de ce serveur : aucun code à chercher ».
“Directly from home” means: an address like 192.168.x.x or 10.x.x.x, typed in the browser as an address or a local name (nas.local), not through the Internet.« Directement depuis la maison » veut dire : une adresse comme 192.168.x.x ou 10.x.x.x, tapée dans le navigateur sous forme d’adresse ou de nom local (nas.local), pas en passant par Internet.
When the wizard asks for a codeQuand l’assistant demande un code
The wizard asks for a setup code when it cannot be sure you are at home:L’assistant demande un code d’installation quand il ne peut pas être sûr que vous êtes à la maison :
- you open it through the Internet or a domain name;vous l’ouvrez par Internet ou par un nom de domaine ;
- Docker Desktop (Mac, Windows) or colima hide your real address: every visitor looks the same;Docker Desktop (Mac, Windows) ou colima cachent votre vraie adresse : tous les visiteurs se ressemblent ;
- another device of the house has already started the setup.un autre appareil de la maison a déjà commencé l’installation.
The code proves you control the machine: only someone who can read the server’s log can type it. It is used once.Le code prouve que vous avez la main sur la machine : seul qui peut lire le journal du serveur peut le taper. Il ne sert qu’une fois.


Where to find the codeOù trouver le code
At every start, as long as the setup is not finished, the server writes the code in its log (its “logs”). Below the field, “Where is it?” shows the commands for your case, with the ID of this very container. Look for this block:À chaque démarrage, tant que l’installation n’est pas finie, le serveur écrit le code dans son journal (ses « logs »). Sous le champ, « Où le trouver ? » donne les commandes de votre cas, avec l’identifiant de ce conteneur précis. Cherchez ce bloc :
══════════════════════════════════════════════════════════════
Tentacle — setup code / code d'installation : ABCD-EFGH-JKMN
http://<this-server>:3000/setup#code=ABCD-EFGH-JKMN
Single use. New code: `tentacle setup token` in this container's console.
Usage unique. Code neuf : `tentacle setup token` dans la console de ce conteneur.
══════════════════════════════════════════════════════════════The second line is a link with the code already filled in: replace <this-server> with the machine’s address and open it.La deuxième ligne est un lien où le code est déjà rempli : remplacez <this-server> par l’adresse de la machine et ouvrez-le.
Command lineLigne de commande
docker logs <container>
docker ps # lists the containers, with their names

PortainerPortainer
- Containers › click the Tentacle container (its name ends with
tentacle-1).Containers › cliquez sur le conteneur Tentacle (son nom finit partentacle-1). - Logs: the code is written there.Logs : le code y est écrit.
- No code, or already used? Console › Connect, then type
tentacle setup token.Pas de code, ou déjà utilisé ? Console › Connect, puis tapeztentacle setup token.


Docker ComposeDocker Compose
From the folder that holds compose.yaml:Depuis le dossier qui contient compose.yaml :
docker compose logs tentacle
docker compose exec tentacle tentacle setup tokenSynology, Unraid and other interfacesSynology, Unraid et autres interfaces
- Synology: Container Manager › Container › the Tentacle container › Details › Log. For a new code: Action › Open terminal, then
tentacle setup token.Synology : Container Manager › Conteneur › le conteneur Tentacle › Détails › Journal. Pour un code neuf : Action › Ouvrir le terminal, puistentacle setup token. - Unraid: Docker tab, click the container’s icon › Logs (or Console).Unraid : onglet Docker, cliquez sur l’icône du conteneur › Logs (ou Console).
- Elsewhere: the container’s “Log” or “Logs” page.Ailleurs : la page « Journal » ou « Logs » du conteneur.


data/setup-token.txt, in the data volume.Le code en vigueur est aussi écrit dans data/setup-token.txt, dans le volume de données.Questions you might haveLes questions qu’on se pose
“This code is wrong, or it was already used”« Ce code n’est pas le bon, ou il a déjà servi »
A code works once. Read the latest one in the log (the last block), or ask for a new one: tentacle setup token in the container’s console (docker exec <container> tentacle setup token).
Un code ne sert qu’une fois. Lisez le dernier dans le journal (le dernier bloc), ou demandez-en un neuf : tentacle setup token dans la console du conteneur (docker exec <conteneur> tentacle setup token).
“Too many attempts”« Trop d’essais »
Five tries per minute and per address. Wait one minute. After ten wrong codes, a new one is written in the log.
Cinq essais par minute et par adresse. Patientez une minute. Après dix codes faux, un nouveau est écrit dans le journal.
I am at home, yet it asks for a codeJe suis à la maison, et il demande quand même un code
Three usual reasons: you typed a domain name (use the machine’s address instead); Docker Desktop or colima hide your address (normal on Mac and Windows: use the code); or another device of the house started the wizard first — it keeps its place, and every other device needs the code.
Trois raisons habituelles : vous avez tapé un nom de domaine (utilisez plutôt l’adresse de la machine) ; Docker Desktop ou colima cachent votre adresse (normal sur Mac et Windows : utilisez le code) ; ou un autre appareil de la maison a commencé l’assistant avant — il garde sa place, et tout autre appareil a besoin du code.
“An installation was already started from another device”« Une installation a déjà été commencée depuis un autre appareil »
Someone (maybe you, on your phone) opened the wizard first. Give the code to take over here. If you do not know who it was, finish the setup quickly, then check the accounts.
Quelqu’un (peut-être vous, sur votre téléphone) a ouvert l’assistant avant. Donnez le code pour reprendre ici. Si vous ne savez pas qui c’était, finissez vite l’installation, puis vérifiez les comptes.
“The installation is already done on this server”« L’installation est déjà faite sur ce serveur »
Once finished, the wizard closes for good. To open it again, from the machine: tentacle setup reset.
Une fois finie, l’assistant se ferme pour de bon. Pour le rouvrir, depuis la machine : tentacle setup reset.
Is the code a password I must keep?Le code est-il un mot de passe à garder ?
No. It only serves during the setup, once. Your real password is the administrator account you create a few screens later.
Non. Il ne sert que pendant l’installation, une fois. Votre vrai mot de passe, c’est le compte administrateur que vous créez quelques écrans plus loin.