Installing and Configuring Netbird to Link Servers

This is the manual guide and it works for everyone. If you use our remnawave-reverse-proxy script, its module does all of this automatically: NetBird: the script module.

Netbird is an open-source platform based on WireGuard that allows you to easily create secure private networks. In this guide, we will walk through how to install and configure Netbird to link your Remnawave panel and nodes so they can communicate securely with each other.

Authors and projects

The project behind the guide and the author of the page.

NetBird

The network of this guide: WireGuard tunnels link the servers into a private network without public ports.

BaseWireGuardNetworksprivate, between servers

netbirdio@netbirdio

↗ netbird

The guide

Written and maintained by the author of the remnawave-reverse-proxy script.

Scriptremnawave-reverse-proxyTelegramt.me/remnawave_reverse

eGamesAPI@eGamesAPI

↗ remnawave-reverse-proxy

How it is arranged

The app.netbird.io cloud issues an account and a setup key. Servers join the network with that key: both the panel server and the node server run netbird up --setup-key and receive an address like 100.x.x.x. The panel then reaches the node at that address on port 2222, and the node firewall opens the port for the panel address only.

Registering on Netbird

1. Open your browser and go to the following link.

   https://app.netbird.io/

2. Create an account.

   

3. Click Sign Up. Choose a registration method: via email, Google, GitHub, or Microsoft.

4. Fill in the fields (email, password) and confirm your registration via the email you receive.

5. After this, you will be taken to the Netbird Dashboard.

   

Creating and Configuring a Setup Key

Note

Setup key is a pre-authentication key that allows to register new machines in your network. It simply associates a machine with an account on a first run.

1. Go to the Setup Keys section. Click the Create Setup Key button.

   

2. Create the key.

   

3. Enter a name for the key (e.g., Key).

4. Enable the Make this key reusable slider so the key can be used for multiple servers (up to 30 peers).

5. Set Expires in to Unlimited so the key does not expire.

6. Click Create Setup Key.

7. Save your key. A window will appear with the generated key. Copy the key and save it in a safe place for future use.

   

Installing Netbird on the Panel Server Remnawave

1. Click the Install Netbird button. A window with installation instructions will open.

   

2. Install Netbird on the Remnawave panel server. Run the command to install Netbird:

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

   

3. Launch Netbird with the key you copied earlier. Execute the command to connect using the saved key (you will have your own key):

   netbird up --setup-key YOUR-COPIED-KEY

   

4. Wait for the Connected message, indicating a successful connection.

Verifying the Connection

Return to the Dashboard and go to the Peers section.

Ensure that the Remnawave panel peer is shown as connected.

Installing Netbird on the Node Server Remnawave

Follow the same installation steps as on the panel server.

Return to the Dashboard Netbird and go to the Peers section. Ensure that the node peer is shown as connected.

Configuring the Firewall (UFW) on the Node Server

In the Netbird Dashboard, find the Netbird IP address of the panel Remnawave (in our case, it’s 100.88.38.121; yours may be different). Run the command to open port 2222 (TCP) for this IP:

ufw allow from 100.88.38.121 to any port 2222 proto tcp

Reload the firewall:

ufw reload

Configuring IP adress Netbird in the Remnawave Panel

1. Go to your Remnawave panel, navigate to Nodes → Manage.

2. Select the node where Netbird is installed.

3. In the Address field, enter the Netbird IP address of the node (in our case, it’s 100.88.74.220; yours may be different).

   

   Click the Save button.

Verifying the Connection

The node is now connected to the Remnawave panel via Netbird. Ensure that the connection between the panel and the node is working (e.g., check access via IP with ping or SSH).

Summary

• Your Remnawave panel and the node server are now linked through a secure Netbird tunnel.
• You can use this channel for secure data exchange or to manage the node via port 2222.
• Netbird simplifies setup and provides high security through WireGuard.