{"id":15172757,"url":"https://github.com/azagramac/wireguard-docker","last_synced_at":"2026-02-04T15:33:05.484Z","repository":{"id":276572255,"uuid":"910861777","full_name":"azagramac/wireguard-docker","owner":"azagramac","description":"WireGuard® is an extremely simple yet fast and modern VPN that utilizes state-of-the-art cryptography. It aims to be faster, simpler, leaner, and more useful than IPsec, while avoiding the massive headache.","archived":false,"fork":false,"pushed_at":"2025-01-01T17:09:47.000Z","size":16,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-21T04:39:08.190Z","etag":null,"topics":["docker","docker-compose","docker-swarm","vpn-server","wireguard","wireguard-docker","wireguard-server","wireguard-vpn"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/azagramac.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-01T16:55:51.000Z","updated_at":"2025-01-01T17:13:00.000Z","dependencies_parsed_at":null,"dependency_job_id":"a2dbefd0-f2b0-4f98-b546-5ce5fbe5c49a","html_url":"https://github.com/azagramac/wireguard-docker","commit_stats":null,"previous_names":["azagramac/wireguard-docker"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/azagramac/wireguard-docker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azagramac%2Fwireguard-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azagramac%2Fwireguard-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azagramac%2Fwireguard-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azagramac%2Fwireguard-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/azagramac","download_url":"https://codeload.github.com/azagramac/wireguard-docker/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azagramac%2Fwireguard-docker/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262465750,"owners_count":23315638,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","docker-compose","docker-swarm","vpn-server","wireguard","wireguard-docker","wireguard-server","wireguard-vpn"],"created_at":"2024-09-27T10:04:14.478Z","updated_at":"2026-02-04T15:33:05.455Z","avatar_url":"https://github.com/azagramac.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"[![GitHub Release](https://img.shields.io/github/release/linuxserver/docker-wireguard.svg?color=88171a\u0026labelColor=555555\u0026logoColor=ffffff\u0026style=for-the-badge\u0026logo=wireguard)](https://github.com/linuxserver/docker-wireguard/releases)\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/03753398-c668-4759-b712-407fdc04390e\" width=\"450\" title=\"logo_wg\"\u003e\n\u003c/p\u003e\n\n### Requeriments\n- Service docker running.\n- Open port 51820 UDP on the router (you can customize a port).\n- Change the variable `SERVERURL=YOUR_DOMAIN` with your domain name.\n- Change the IPv4 range of the `ALLOWEDIPS=192.168.1.0/24` variable to the appropriate one.\n\n#### Optional\nIf you have a server with [AdGuardHome](https://github.com/azagramac/adguardhome-docker) or PiHole, you can put the IP of the server where you have that service running in the variable `PEERDNS=1.1.1.1,1.0.0.1` or use other public DNS. \n\n| Architecture | Available |\n| :----: | :----: |\n| x86-64 | ✅ |\n| amd64 | ✅ |\n| aarch64 | ✅ |\n| arm64v8 | ✅ |\n| arm64v9 | ✅ |\n| x86 | ❌ | |\n| armhf | ❌ | |\n| armv7 | ❌ | |\n\n### Install Docker (Ubuntu, Debian, Armbian, DietPi...)\n    sudo apt update \u0026\u0026 sudo apt install git vim wget curl net-tools ca-certificates gnupg -y\n    sudo install -m 0755 -d /etc/apt/keyrings\n    sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc\n    sudo chmod a+r /etc/apt/keyrings/docker.asc\n    \n    echo \\\n      \"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \\\n      $(. /etc/os-release \u0026\u0026 echo \"$VERSION_CODENAME\") stable\" | \\\n      sudo tee /etc/apt/sources.list.d/docker.list \u003e /dev/null\n    \n    sudo apt update \u0026\u0026 sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y\n    sudo usermod -aG docker $USER\n    sudo reboot\n\n### Test Docker\n    root@nanopi-neo3:~$ docker version\n    Client: Docker Engine - Community\n     Version:           27.3.1\n     API version:       1.47\n     Go version:        go1.22.7\n     Git commit:        ce12230\n     Built:             Fri Sep 20 11:41:19 2024\n     OS/Arch:           linux/arm64\n     Context:           default\n    \n    Server: Docker Engine - Community\n     Engine:\n      Version:          27.3.1\n      API version:      1.47 (minimum version 1.24)\n      Go version:       go1.22.7\n      Git commit:       41ca978\n      Built:            Fri Sep 20 11:41:19 2024\n      OS/Arch:          linux/arm64\n      Experimental:     false\n     containerd:\n      Version:          1.7.24\n      GitCommit:        88bf19b2105c8b17560993bee28a01ddc2f97182\n     runc:\n      Version:          1.2.2\n      GitCommit:        v1.2.2-0-g7cb3632\n     docker-init:\n      Version:          0.19.0\n      GitCommit:        de40ad0\n      \n    root@nanopi-neo3:~$ docker compose version\n    Docker Compose version v2.29.7\n\n### Clone repo\n    git clone https://github.com/azagramac/wireguard-docker.git\n    cd wireguard-docker\n\n### Running\n    docker compose up -d\n\n### Output\n    $ docker compose up -d\n    [+] Running 9/9\n     ✔ wireguard Pulled                                                                                                                                                                                                                             23.2s \n       ✔ 646ff129efa7 Pull complete                                                                                                                                                                                                                  4.5s \n       ✔ df25a931801a Pull complete                                                                                                                                                                                                                  5.2s \n       ✔ c116abe7e7b3 Pull complete                                                                                                                                                                                                                  5.7s \n       ✔ ec142417d43e Pull complete                                                                                                                                                                                                                  5.9s \n       ✔ ef02aa7fa9ff Pull complete                                                                                                                                                                                                                 10.6s \n       ✔ 9ae179c60632 Pull complete                                                                                                                                                                                                                 10.9s \n       ✔ 0203081f93d0 Pull complete                                                                                                                                                                                                                 21.8s \n       ✔ 9b56ac8a03b4 Pull complete                                                                                                                                                                                                                 22.0s \n    [+] Running 2/2\n     ✔ Network wireguard_default  Created                                                                                                                                                                                                            0.4s \n     ✔ Container wireguard        Started\n\n### Check\n    docker ps -a\n\n### Output\n    $ docker ps -a\n    CONTAINER ID   IMAGE                                          COMMAND                  CREATED         STATUS                  PORTS                      NAMES\n    eb8849811b3f   ghcr.io/linuxserver/wireguard:arm64v8-latest   \"/init\"                  2 minutes ago   Up About a minute       0.0.0.0:51820-\u003e51820/udp   wireguard\n\n### Running on docker swarm 🐳\n    cd wireguard-docker\n    docker stack deploy --compose-file compose.yml wireguard\n\n### Check on docker swarm 🐳\n     $ docker service ls\n     ID             NAME                   MODE         REPLICAS   IMAGE                                  PORTS                 \n     dmbht3wp5asz   wireguard_vpn          replicated   1/1        ghcr.io/linuxserver/wireguard:latest   *:51820-\u003e51820/udp\n     \n     $ docker service ps wireguard_vpn\n     ID             NAME              IMAGE                                  NODE      DESIRED STATE   CURRENT STATE               ERROR     PORTS\n     t1gsvql9cage   wireguard_vpn.1   ghcr.io/linuxserver/wireguard:latest   master    Running         Running 44 hours ago\n\n### Show QR config client 1, change number for show config client 2, 3... \n    docker exec -it wireguard /app/show-peer 1\n\n### Monitor traffic from a connected client\n    docker exec -it wireguard wg show\n\n### Download App\n\u003ca href=\"https://play.google.com/store/apps/details?id=com.wireguard.android\"\u003e\u003cimg src=\"https://lh3.googleusercontent.com/q1k2l5CwMV31JdDXcpN4Ey7O43PxnjAuZBTmcHEwQxVuv_2wCE2gAAQMWxwNUC2FYEOnYgFPOpw6kmHJWuEGeIBLTj9CuxcOEeU8UXyzWJq4NJM3lg=s0\" width=\"130px\"\u003e\u003c/a\u003e  \u003ca href=\"https://apps.apple.com/es/app/wireguard/id1441195209\"\u003e\u003cimg src=\"https://upload.wikimedia.org/wikipedia/commons/thumb/3/3c/Download_on_the_App_Store_Badge.svg/640px-Download_on_the_App_Store_Badge.svg.png\" width=\"130px\"\u003e\u003c/a\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.githubassets.com/assets/mona-loading-default-c3c7aad1282f.gif\" width=\"40\" title=\"git\"\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fazagramac%2Fwireguard-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fazagramac%2Fwireguard-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fazagramac%2Fwireguard-docker/lists"}