WireGuard-Go

WireGuard-Go is a userspace implementation of the WireGuard VPN protocol written in Go, used to run encrypted VPN tunnel interfaces on hosts without Linux…

  • Network Services
WireGuard-Go is a userspace implementation of the WireGuard VPN protocol written in Go, used to run encrypted VPN tunnel interfaces on hosts without Linux kernel module support.

Platform availability

Available on 2 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

58/100 Fair

Maintained
77last commit 27 days ago
Popular
734,504 GitHub stars
Easy to install
250 install platforms, install notes, Docker image
Light to run
100128 MB minimum RAM
Security check
07 serious findings, 2 minor, tests, OpenSSF Scorecard 3/10
GitHub stars
4,504
Open issues
34
Last commit
2026-10-24
License
MIT
Activity
rising

Checked 16 days ago - source: GitHub (WireGuard/wireguard-go)

Resources & Compatibility

Minimum requirements: 128 MB RAM, 16 MB disk. ARM (e.g. Raspberry Pi) is not supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Use the required Docker flags Start the container with --cap-add=NET_ADMIN, -p 51820:51820/udp, PUID/PGID (the user and group IDs it runs as), TZ, a mapped /config folder, --sysctl net.ipv4.conf.all.src_valid_mark=1, and --restart unless-stopped. These let clients reach the VPN, keep settings and keys persistent, and bring it back after a host restart. source
  • Keep the /config folder safe The container stores tunnel settings in /config/wg_confs and DNS settings in /config/coredns, so that folder is your real configuration. If it is deleted or not backed up, you can lose your VPN keys, peer details, and DNS rules. source
  • Use one .conf file per tunnel Add each WireGuard tunnel as its own .conf file under /config/wg_confs, and the container will detect and start them on launch. If a tunnel file is missing or misnamed, that tunnel will not come up even if the container appears healthy. source
  • Running the binary Run 'wireguard-go <interface>' (e.g. 'wireguard-go wg0') to create the tunnel interface and background it; add -f to run in the foreground, and remove it with 'ip link del wg0'. source

Fetched 42 days ago - each note links to its source

Alternatives (12)

  • Amnezia VPN - Enables classic, free, and self-hosted VPN modes, works under high censorship, uses a WireGuard-based protocol for better blocking resistan…
  • Fossorial Pangolin - Open-source identity-based remote access platform using WireGuard, offering unified management, tunneled connections, granular access contr…
  • LogMeIn Hamachi - Seamlessly connects devices and networks, extending LAN-like connectivity to mobile users and teams with a secure, hosted VPN service.
  • OpenVPN Connect - OpenVPN Connect provides flexible VPN solutions to secure your data communications, whether it's for Internet privacy, remote access for em…
  • Outline VPN - Journalists need safe access to information to research issues, communicate with sources, and report the news.
  • Shadowsocks - Shadowsocks is a self-hosted SOCKS5 proxy that uses the open-source Shadowsocks encryption protocol.
  • SoftEther VPN - SoftEther VPN (&quot;SoftEther&quot; means &quot;Software Ethernet&quot;) is one of the world's most powerful and easy-to-use multi-protoco…
  • Tailscale - Private networks made easy.
  • WireGuard - WireGuard is a fast, lightweight virtual private network (VPN) server that creates encrypted point-to-point tunnels for secure remote acces…
  • ZeroTier - ZeroTier is an open-source, cross-platform virtual LAN/VPN service that connects your devices and servers into one private network, so you…
  • defguard - defguard is an SSO &amp; VPN Server based on OpenID and WireGuard VPN with unique secure &amp; private architecture for building secure and…
  • nostr vpn - Nostr VPN turns your Umbrel into a private mesh VPN node for your own devices and trusted groups.

Checked 40 days ago - source: AlternativeTo

Common questions

What Docker settings are needed for a WireGuard container to accept clients and keep settings persistent?

Start the container with --cap-add=NET_ADMIN and -p 51820:51820/udp so clients can reach the VPN. Also set PUID/PGID, TZ, map /config, add --sysctl net.ipv4.conf.all.src_valid_mark=1, and use --restart unless-stopped.

Which folder should be backed up to avoid losing WireGuard settings?

Back up the mapped /config folder because the container stores tunnel settings in /config/wg_confs and DNS settings in /config/coredns. If it is deleted or not backed up, you can lose VPN keys, peer details, and DNS rules.

How can you remove a WireGuard interface or shut down wireguard-go?

Use ip link del wg0 to remove the interface. If the system does not support removing interfaces directly, remove the control socket, which will shut wireguard-go down.

Answers sourced from github.com, github.com, github.com

Community

Collected 48 days ago - public community threads