Maintained by Thijmen Heuvelink

The easiest way to install & manage WireGuard on any Linux host, this docker image comes with a web ui to easily manage your whitelist vpn connections.

Install WG-Easy

1. Generate a hash for your password

docker run -it ghcr.io/wg-easy/wg-easy wgpw YOUR_PASSWORD

2. Copy the generated hash, use it in the compose file

Remove the single quotes and insert an extra $ before each existing $

services:
  wireguard:
    image: ghcr.io/wg-easy/wg-easy
    container_name: wireguard
    environment:
      WG_HOST: "ext.heuve.link"
      PASSWORD_HASH: "<Your Generated Hash>"
      WG_DEFAULT_DNS: 1.1.1.1
    volumes:
      - ./data:/etc/wireguard
    ports:
      - "51820:51820/udp"
      - "51821:51821/tcp"
    cap_add:
      - NET_ADMIN
      - SYS_MODULE
    sysctls:
      net.ipv4.conf.all.src_valid_mark: "1"
      net.ipv4.ip_forward: "1"
    restart: unless-stopped

Starting it

docker-compose up -d

Preview

Preview

This knowledge base serves as a valuable tool to simplify installations, troubleshoot common problems and to enhance the overall developer / admin experience. mail@thijmenheuvelink.nl - all rights reserved