Connect to VbSE
Download your WireGuard configuration and set up your VPN tunnel.
Loading...
Your account hasn't been approved yet, or your WireGuard config is not yet provisioned. Contact an admin.
Your WireGuard Config
Scan with WireGuard mobile app
Setup Instructions
Install WireGuard and bring up the tunnel:
sudo apt install wireguard # Debian/Ubuntu sudo cp wg0.conf /etc/wireguard/wg0.conf sudo wg-quick up wg0 # To connect automatically on boot: sudo systemctl enable wg-quick@wg0
Install the WireGuard app from the Mac App Store, then import your config:
- Download WireGuard from the Mac App Store
- Open WireGuard → Import tunnel(s) from file
- Select the
wg0.confyou downloaded - Click Activate
Or via Homebrew: brew install wireguard-tools and use wg-quick up ./wg0.conf
Download the official WireGuard client for Windows:
- Download the installer from wireguard.com/install
- Run the installer and open WireGuard
- Click Import tunnel(s) from file
- Select
wg0.conf - Click Activate
Note: Do not add an
MTU = line to the config when using the Windows client — it causes an error on some versions.
Install the WireGuard app and scan the QR code above:
- Install WireGuard from Google Play or App Store
- Open the app → tap + → Scan from QR code
- Scan the QR code shown above
- Give the tunnel a name and tap Create Tunnel
- Enable the toggle to connect
Run WireGuard and the VbSE monitoring agent as Docker containers:
services:
wireguard:
image: linuxserver/wireguard:latest
container_name: my-wireguard
cap_add:
- NET_ADMIN
- SYS_MODULE
volumes:
- ./wg0.conf:/config/wg_confs/wg0.conf:ro
restart: unless-stopped
agent:
build: https://github.com/luizosorio/vbsx.net.git#master:services/agent
container_name: my-vbse-agent
network_mode: "container:my-wireguard"
cap_add:
- NET_ADMIN
volumes:
- /proc:/host/proc:ro
environment:
- PROC_PATH=/host/proc
- COLLECT_INTERVAL=30
restart: unless-stopped
depends_on:
- wireguard
Save your wg0.conf in the same directory, then run docker compose up -d.
The agent exposes Prometheus metrics on port 9101, shared via the WireGuard container's network namespace.