Files
nix-config/modules/nixos/desktop/networking/netbird.nix
2026-03-13 10:47:32 +08:00

39 lines
1.2 KiB
Nix
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
{
lib,
pkgs,
...
}:
# =============================================================
#
# NetBird - your own private network(VPN) that uses WireGuard, Coturn, etc.
#
# It's similar to tailscale, but netbird's more opensouse and less mature.
#
# NetBird natively supports running multiple clients on the same host — something
# Tailscale cant do easily.
# Its NixOS module ships a dedicated CLI wrapper for every client, so managing them is effortless.
#
# How to use:
# 1. Create a NetBird account at https://app.netbird.io/
# 3. Login & join into your homelab network via `netbird-homelab up`
#
# Status Data:
# `journalctl -u netbird-homelab` shows netbird's logs
# netbird client store its data in /var/lib/netbird-homelab & /etc/netbird-homelab
# which is already persistent across reboots(via preservation)
#
# References:
# https://github.com/NixOS/nixpkgs/blob/nixos-unstable/nixos/modules/services/networking/netbird.nix
#
# =============================================================
{
services.netbird.useRoutingFeatures = "client";
services.netbird.clients.homelab = {
port = 51820;
name = "homelab";
interface = "netbird-homelab";
hardened = true;
autoStart = true;
};
}