Your first network

Install EdgeVPN, generate a token, and bring up a two-node VPN.

Get EdgeVPN

Prerequisites: No dependencies. EdgeVPN releases are statically compiled.

On Linux, the quickest way is the install script:

curl -sfL https://raw.githubusercontent.com/mudler/edgevpn/master/install.sh | sh

Release archives, Homebrew, the container image and building from source are all covered in Install EdgeVPN.

Creating Your First VPN

Let’s create our first vpn now and start it:

$> EDGEVPNTOKEN=$(edgevpn -b -g)
$> edgevpn --dhcp --api

That’s it!

You can now access the web interface on http://localhost:8080.

To join new nodes in the network, simply copy the EDGEVPNTOKEN and use it to start edgevpn in other nodes:

$> EDGEVPNTOKEN=<token_generated_before> edgevpn --dhcp
Last modified August 4, 2026: Fix/proxy egress ownership (#1066) (cfb9c39)