homelab/netbird
Watch
2
0
Fork
You've already forked netbird
 0
Code Issues 1 Pull requests Projects Releases Packages Wiki Activity Actions
No description
16 commits 1 branch 0 tags 44 KiB
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Manu 809339a4b9
All checks were successful
Validation / compose-images (push) Successful in 16s
Details
Validation / renovate-config (push) Successful in 2s
Details
Merge pull request 'chore(deps): update netbirdio/netbird-server:latest docker digest to 7b5b53b' (#7) from renovate/netbirdio-netbird-server-latest into main 
Reviewed-on: #7
2026-11-03 11:29:15 +01:00
.forgejo/workflows fix(ci): inspect pinned image digests independently of tags 2026-10-19 21:30:36 +02:00
.gitignore Configure NetBird deployment and Renovate validation 2026-10-14 01:07:35 +02:00
Caddyfile feat: initial commit 2026-10-14 01:01:52 +02:00
dashboard.env feat: initial commit 2026-10-14 01:01:52 +02:00
docker-compose.yml chore(deps): update netbirdio/netbird-server:latest docker digest to 7b5b53b 2026-10-29 15:01:40 +00:00
README.md docs: rename repository references to netbird 2026-10-16 22:51:11 +02:00
renovate.json Configure NetBird deployment and Renovate validation 2026-10-14 01:07:35 +02:00

README.md

NetBird

Le dépôt Forgejo homelab/netbird contient la stack NetBird. Déploiement sur Saturn (serveur Komodo Local) dans /opt/netbird, projet Compose netbird. Conserver ce nom : le volume existant est netbird_netbird_data.

Configuration du serveur

Conserver /opt/netbird/config.yaml et le volume de données existants. Le fichier de configuration contient les secrets et reste hors Git. Créer /opt/netbird/.komodo.env vide si aucun paramètre Compose supplémentaire n'est nécessaire. Le dashboard utilise le fichier versionné dashboard.env.

Le dashboard publie 127.0.0.1:18080, le serveur 127.0.0.1:8081 et STUN 3479/udp. Le Caddy central utilise le fragment Caddyfile de ce dépôt ; vérifier son montage et le certificat de netbird.thuillier.online.

Renovate et Komodo

La configuration Renovate suit les conventions des autres stacks : digests épinglés, mises à jour mineures/patchs fusionnées après les checks, majeures et digests manuels. La CI vérifie Compose, les images et la configuration Renovate.

  1. Donner à renovate-bot accès en écriture et droit de fusion sur homelab/netbird, et à komodo-bot accès en lecture.
  2. Publier les modifications des dépôts NetBird, Forgejo, Komodo et infra. Recharger le bot Renovate après mise à jour de sa liste de dépôts.
  3. Avant la synchronisation Komodo, vérifier que /opt/netbird est un clone de ssh://git@forge.thuillier.online/homelab/netbird.git sur main. Si le dossier provient de l'installateur, conserver les fichiers actifs et secrets lors de sa conversion en clone. Comparer les ports et montages avant de déployer.
  4. Synchroniser les ressources infra : la stack netbird réutilise le projet et le volume existants. reclone = false préserve les fichiers hors Git.
  5. Ajouter sur Forgejo le webhook Push vers l'URL Deploy de la stack NetBird, avec le secret configuré dans Komodo. Protéger main avec les checks compose-images et renovate-config.

Sauvegarder config.yaml avec ses clés et le volume de données de manière cohérente avant la première reprise par Komodo. Ne pas utiliser down -v.