Aller au contenu

Trace install tas - Headscale

De Loic Wiki

Trace install tas - Headscale

Rôle

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

Accès

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.