Netbird-Linux Setup Guide

Install General Systemd-Service

A generic Systemd service will be set up on your host, which serves as the foundation for configuring a specific deployment (Netbird WireGuard interface, etc.).

First: install Netbird, you can use the Official Instruction or the following Linux-Setup-Script.

curl -fsSL https://pkgs.netbird.io/install.sh | sh

# Disable the Default Netbird Service (we dont use it, if you dont need it disable it!)
netbird down
netbird service uninstall

Second: Install our IP-Transit Netbird Systemd-Service. Your system must support systemd services! Most common Systems such as Debian & Ubuntu do that. Follow the Instructions in the Script!

curl -fsSL https://raw.githubusercontent.com/NovaCloud-Hosting/iptransit-collection/refs/heads/main/novacloud-netbird-service.sh | bash 

Start and optionally enable the service for start on system-boot!

Instructions for Proxmox

Follow this Instruction.

Instructions for Assigning IPs to the Netbird Host

ip addr add X.X.X.X/32 dev wt10
# or for IPv6:
ip addr add 1::1/128 dev wt10

Thats it! You might want to schedule these commands to run via a cron job, repeat them for multipile IPs!

Instructions for Providing Network to other Hosts

The interface/VLAN where the IPs are to be assigned must already be configured. Next, assign a gateway from a subnet to the Netbird host and enable IP forwarding.

ip addr add <Gateway>/<CIDR> dev eth0
ip -4 rule add pref 11 from <Gateway>/<CIDR> table 10
# or for ipv6: ip -6 rule add pref 11 from <Gateway>/<CIDR> table 10

# Enable Forwarding
sysctl -w net.ipv4.ip_forward=1
sysctl -w net.ipv6.conf.all.forwarding=1

Your Netbird host will now act as router. You might want to schedule these commands to run via a cron job.