Skip to main content
Peliqan supports self-service activation of the NetBird VPN, a secure software-only VPN that establishes a peer to peer mesh connection between your on-prem server and the Peliqan data cloud. Once the VPN tunnel is active, you can add e.g. a database connection in Peliqan, using the local IP address of your server.

​
About NetBird

NetBird is an open-source, secure, peer-to-peer private network built on top of WireGuard. It enables encrypted connections between devices across different networks without the need for complex VPN setups or static IPs. Ideal for secure connectivity to internal services, NetBird simplifies private networking using a modern control plane. How it works NetBird uses a centralized management service (self-hosted or cloud) to coordinate peer connections and distribute WireGuard keys. Once connected, peers communicate directly using encrypted WireGuard tunnels. Security
  • End-to-end encryption with WireGuard (ChaCha20, Curve25519)
  • Granular access control and group-based permissions
  • Device authorization, NAT traversal, and zero-trust principles
Supported Server operating Systems
  • Linux (including server distributions)
  • macOS
  • Windows (from Windows 10)
More info: https://www.netbird.io/

​
Peliqan NetBird VPN setup guide

This guide applies to installing the NetBird client on both Windows servers and Linux servers. Sign up for a new account on NetBird.io. Ideally do this in a browser directly on the on-prem server that you want to connect with Peliqan. image Select peer-to-peer network: image Download and install the NetBird client, on the on-prem server that you want to connect to Peliqan: image After installing, in the NetBird client, click on “Connect”. This will open a browser window, login with your NetBird account: image Authorize access: image Close the browser window: image You can also connect using the command line: netbird up Or using a Setup Key: netbird up --setup-key <YOUR SETUP KEY> Go back to your NetBird account on https://app.netbird.io: image You will now create a Setup Key for Peliqan. Click on “Install with a Setup Key”. If an Installation popup opens, close it. If you are in the NetBird Dashboard, click on Setup Keys in the left pane and click on “Create Setup Key”. Use following settings for the Setup Key:
  • Name: “Peliqan”
  • “Make this key reusable” needs to be checked
  • Usage Limit: 5 peers (or more)
  • Expires in: Unlimited
  • Ephemeral Peers: not enabled (unchecked)
image Copy the Setup Key and click on Close: image Share the following details with Peliqan Support:
  • Setup key created for Peliqan
  • Netbird IP address of your on-prem server
  • Port of your on-prem database
You can find the Netbird IP address of your server in Netbird under Peers, see for example 100.107.11.28 in the screenshot below: image Peliqan will configure its client and confirm connectivity to your on-prem server.
Important! Make sure to disable Peer Session Expiration in Netbird, under Settings > Authentication, to make sure your connection does not get disconnected:image
Once Peliqan Support confirms that the VPN is active: in Peliqan go to Connections > Add Connection > Search e.g. for “SQL Server”. Enter the connection details, and use the internal hostname that you received from Peliqan Support. Example: image

​
Troubleshooting

If needed, run the command netbird status and check if the response includes Signal:connected. image

​
Connect to an on-prem SQL Server (Windows server)

Make sure TCP/IP is enabled in your SQL Server Configuration Manager: image

​
Running the VPN client on a separate machine

If you run the VPN Client (NetBird) on the same machine as your local on-prem DB (or other data source), you can directly connect from the Peliqan Cloud to the on-prem resource, using the IP address of the VPN network and the correct port of the DB: image If you run the VPN Client (NetBird) on a separate server or virtual machine (VM), you have to set up port forwarding on that machine, to the server with the on-prem DB (or other data source): image Set up port forwarding on Linux with IP Tables. Set up port forwarding on Windows Server using netsh. Example to add a port forwarding for SQL Server with port 1433:
To list all port forwardings:
To delete a port forwarding: