Dernière version du 19 mars 2026 à 00:48

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.

@@ Ligne 2 : / Ligne 2 : @@
 == Rôle ==
-Contrôleur Tailscale self-hosted + interface web.
+Contrôleur Tailscale self-hosted et interface Headscale UI.
 == Accès ==
-* Local : API sur 8089, UI sur 8090
+* 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 ==
-API, 8090 UI, 25689 public avec routage différencié
+API, 8090 UI, 25689 public avec routage /web* vers UI
 == Exécution / runtime ==
-Conteneurs headscale et systemd-headscale-ui
+Quadlets systemd user : headscale.container et headscale-ui.container ; conteneurs headscale et systemd-headscale-ui
-== Installation / configuration ==
+== Chemins de configuration ==
-Caddy route /web* vers 8090, le reste vers 8089.
+* /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 ==
-Bien distinguer API Headscale et interface Headscale UI.
+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]].
+Cette page fait partie de [[Trace install tas]].