2026-06-13 14:46:55 +02:00
2026-06-12 15:11:01 +00:00
WIP
2026-06-13 14:46:55 +02:00
2026-06-12 15:11:01 +00:00
wip
2024-12-08 09:45:29 +01:00
2026-06-12 18:59:18 +02:00
2026-06-12 18:59:18 +02:00
2026-06-12 18:22:25 +02:00

vppn: Virtual Potentially Private Network

Hub Server Configuration

# Create user.
adduser user

# Enable ssh.
cp -r ~/.ssh /home/user/
chown -R user:user /home/user/.ssh

Upload hub executable:

scp hub user@<remote>:~/

Create systemd file in `/etc/systemd/system/hub.service

[Service]
AmbientCapabilities=CAP_NET_BIND_SERVICE
Type=simple
User=user
WorkingDirectory=/home/user/
ExecStart=/home/user/hub -listen <addr>:https -root-dir=/home/user
Restart=always
RestartSec=8

[Install]
WantedBy=default.target

Add and start the hub server:

systemctl daemon-reload
systemctl enable hub
systemctl start hub

Get initial password from logs:

journalctl -f -u hub -n 100

Sign-in and configure.

Peer Configuration

Install the binary somewhere, for example ~/bin/vppn.

Add the API key for your network name in ~/.vppn/<netname>/apikey.

Create systemd file in /etc/systemd/system/vppn.service.

[Service]
AmbientCapabilities=AP_NET_ADMIN CAP_DAC_OVERRIDE CAP_CHOWN
Type=simple
User=user
WorkingDirectory=/home/user/
ExecStart=/home/user/bin/vppn -name my_net_name -hub https://my.hub
Restart=always
RestartSec=8
TimeoutStopSec=24

[Install]
WantedBy=multi-user.target

Add and start the service:

systemctl daemon-reload
systemctl enable vppn
systemctl start vppn
Description
No description provided
Readme MIT 17 MiB
v0.8.0 Latest
2025-09-17 08:00:47 +00:00
Languages
Go 95.5%
HTML 4.3%
CSS 0.2%