Trace install tas - Headscale

Trace install tas - Headscale

Rôle

Contrôleur Tailscale self-hosted et interface Headscale UI.

Accès

• Local : API sur http://10.8.0.1:8089 et UI sur http://10.8.0.1:8090
• Public : https://lololand.hopto.org:25689

Ports

8089 API, 8090 UI, 25689 public avec routage /web* vers UI

Exécution / runtime

Quadlets systemd user : headscale.container et headscale-ui.container ; conteneurs headscale et systemd-headscale-ui

Chemins de configuration

• /home/loic/.config/containers/systemd/headscale.container
• /home/loic/.config/containers/systemd/headscale-ui.container
• /home/loic/headscale/config
• /home/loic/headscale/data

Volumes / persistance

• /home/loic/headscale/config -> /etc/headscale
• /home/loic/headscale/data -> /var/lib/headscale

Dépendances

• Caddy 25689 avec handle /web* -> 8090 et handle -> 8089

Remarques

La séparation API/UI est importante. Le port 8089 ne doit pas être réutilisé pour d'autres services documentaires.

Données / emplacements à sauvegarder

• Configuration : /home/loic/headscale/config
• Données : /home/loic/headscale/data

Sauvegarde

• Sauvegarder /home/loic/headscale/config et /home/loic/headscale/data.
• Exporter les quadlets headscale.container et headscale-ui.container.

Restauration

• Restaurer /home/loic/headscale/config et /home/loic/headscale/data.
• Relancer Headscale puis Headscale UI et vérifier la route Caddy /web*.

Maintenance documentaire

Lors d'un changement de config Headscale, de pairing, de routage /web* ou de données persistées, mettre à jour cette page et la page centrale.

Trace documentaire

Cette page fait partie de Trace install tas.