{"id":35238256,"url":"https://github.com/supersunho/docker-adguardvpn-cli","last_synced_at":"2026-04-02T01:29:19.862Z","repository":{"id":274794781,"uuid":"919910681","full_name":"supersunho/docker-adguardvpn-cli","owner":"supersunho","description":"Multi-architecture Docker images for AdGuard VPN CLI with automated builds. Supports amd64, arm64, and armv7 platforms with daily CI/CD pipeline via GitHub Actions. Available on Docker Hub and GitHub Container Registry.","archived":false,"fork":false,"pushed_at":"2026-01-13T14:24:30.000Z","size":136,"stargazers_count":15,"open_issues_count":2,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-01-13T16:55:04.535Z","etag":null,"topics":["adguard","docker","killswitch","vpn","vpn-cli"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/supersunho/adguardvpn-cli","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/supersunho.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-01-21T08:31:18.000Z","updated_at":"2026-01-13T14:19:10.000Z","dependencies_parsed_at":"2025-01-29T13:22:26.036Z","dependency_job_id":"d143975d-2e0d-4289-9ec3-faebdabf6e83","html_url":"https://github.com/supersunho/docker-adguardvpn-cli","commit_stats":null,"previous_names":["supersunho/docker-adguardvpn-cli"],"tags_count":18,"template":false,"template_full_name":null,"purl":"pkg:github/supersunho/docker-adguardvpn-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supersunho%2Fdocker-adguardvpn-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supersunho%2Fdocker-adguardvpn-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supersunho%2Fdocker-adguardvpn-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supersunho%2Fdocker-adguardvpn-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/supersunho","download_url":"https://codeload.github.com/supersunho/docker-adguardvpn-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supersunho%2Fdocker-adguardvpn-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31293901,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T01:05:07.454Z","status":"ssl_error","status_checked_at":"2026-04-02T00:56:46.496Z","response_time":53,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["adguard","docker","killswitch","vpn","vpn-cli"],"created_at":"2025-12-30T04:11:23.535Z","updated_at":"2026-04-02T01:29:19.852Z","avatar_url":"https://github.com/supersunho.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- Improved compatibility of back to top link: See: https://github.com/othneildrew/Best-README-Template/pull/73 --\u003e\n\n\u003ca id=\"readme-top\"\u003e\u003c/a\u003e\n\n\u003c!--\n*** Thanks for checking out the Best-README-Template. If you have a suggestion\n*** that would make this better, please fork the repo and create a pull request\n*** or simply open an issue with the tag \"enhancement\".\n*** Don't forget to give the project a star!\n*** Thanks again! Now go create something AMAZING! :D\n--\u003e\n\n\u003c!-- PROJECT SHIELDS --\u003e\n\u003c!--\n*** I'm using markdown \"reference style\" links for readability.\n*** Reference links are enclosed in brackets [ ] instead of parentheses ( ).\n*** See the bottom of this document for the declaration of the reference variables\n*** for contributors-url, forks-url, etc. This is an optional, concise syntax you may use.\n*** https://www.markdownguide.org/basic-syntax/#reference-style-links\n--\u003e\n\n[![Contributors][contributors-shield]][contributors-url]\n[![Forks][forks-shield]][forks-url]\n[![Stargazers][stars-shield]][stars-url]\n[![Issues][issues-shield]][issues-url]\n\n\u003c!-- PROJECT LOGO --\u003e\n\u003cbr /\u003e\n\n\u003e [!WARNING]\n\u003e We're currently experiencing auto login issues. After running the container, please manually authenticate through the link that appears in the output and wait a moment - it should work normally after that. Just a heads up again that the automatic login flow isn't working properly at the moment. (2026-01-13)\n\n\u003cdiv align=\"center\"\u003e\n  \u003c!-- \u003ca href=\"https://github.com/supersunho/docker-adguardvpn-cli\"\u003e\n    \u003cimg src=\"images/logo.png\" alt=\"Logo\" width=\"80\" height=\"80\"\u003e\n  \u003c/a\u003e --\u003e\n\n\u003ch3 align=\"center\"\u003eDocker-AdguardVPN-CLI\u003c/h3\u003e\n\n  \u003cp align=\"center\"\u003e\n    \u003ca href=\"https://github.com/AdguardTeam/AdGuardVPNCLI\"\u003eAdGuard VPN CLI\u003c/a\u003e within a Docker container\n    \u003c!-- \u003cbr /\u003e\n    \u003ca href=\"https://github.com/github_username/repo_name\"\u003e\u003cstrong\u003eExplore the docs »\u003c/strong\u003e\u003c/a\u003e\n    \u003cbr /\u003e --\u003e\n    \u003cbr /\u003e\n    \u003c!-- \u003ca href=\"https://github.com/github_username/repo_name\"\u003eView Demo\u003c/a\u003e\n    \u0026middot; --\u003e\n    \u003ca href=\"https://github.com/supersunho/docker-adguardvpn-cli/issues/new?labels=bug\u0026template=bug-report---.md\"\u003eReport Bug\u003c/a\u003e\n    \u0026middot;\n    \u003ca href=\"https://github.com/supersunho/docker-adguardvpn-cli/issues/new?labels=enhancement\u0026template=feature-request---.md\"\u003eRequest Feature\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n\u003c!-- ABOUT THE PROJECT --\u003e\n\n## About The Project\n\n\u003c!-- [![Product Name Screen Shot][product-screenshot]](https://example.com) --\u003e\n\nThis project allows you to use AdguardVPN-CLI within a Docker container. It provides a simple and efficient way to manage AdguardVPN through the command line in a containerized environment.\n\n\u003e [!IMPORTANT] \n\u003e **Authentication Change Notice**: As of version 1.5.10, AdGuard VPN CLI has transitioned from username/password authentication to web-based authentication. The old `ADGUARD_USERNAME` and `ADGUARD_PASSWORD` environment variables are no longer used for authentication, but are kept for backward compatibility in configuration.\n\n\u003c!--\n\n### Built With\n\n* [![Next][Next.js]][Next-url]\n* [![React][React.js]][React-url]\n* [![Vue][Vue.js]][Vue-url]\n* [![Angular][Angular.io]][Angular-url]\n* [![Svelte][Svelte.dev]][Svelte-url]\n* [![Laravel][Laravel.com]][Laravel-url]\n* [![Bootstrap][Bootstrap.com]][Bootstrap-url]\n* [![JQuery][JQuery.com]][JQuery-url]\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e --\u003e\n\n\u003c!-- GETTING STARTED --\u003e\n\n## Getting Started\n\nBefore proceeding, please review the following content and create your .env file accordingly. You can refer to the .env.sample file provided in this repository for guidance.\n\n### Authentication Setup\n\n\u003e [!IMPORTANT] \n\u003e **New Authentication Process**: AdGuard VPN CLI now uses web-based authentication instead of username/password. You need to perform an initial authentication using the web flow before the VPN can connect.\n\n1. **First-time Setup**:\n\n    - Start the main container: `docker-compose up -d`\n    - Check the logs to find the authentication link: `docker logs adguard-vpn-cli`\n    - **When running adguardvpn-cli for the first time, check the docker logs for the authentication link. Once you access the link and complete the authentication, you won't need to authenticate again for subsequent runs. The link format looks like `https://auth.adguard.io/device_code?user_code=xxxx`.**\n    - **Note**: If you have authenticated via the web browser, please wait a moment for the process to continue automatically. It is not frozen.\n    - **Warning**: If Two-Factor Authentication (2FA) is enabled on your account, you may experience issues with this login process.\n\n2. **Volume Mount**: The container now mounts `./data` directory to persist authentication credentials across container restarts.\n\n\u003c!-- USAGE EXAMPLES --\u003e\n\n## How to use\n\nAdguardVPN-CLI + qBittorrent\n\n```yml\nversion: \"3\"\nservices:\n    adguard-vpn-cli:\n        image: supersunho/adguardvpn-cli:latest\n        restart: unless-stopped\n        container_name: adguard-vpn-cli\n        env_file: .env\n        volumes:\n            - ./data:/root/.local/share/adguardvpn-cli\n        healthcheck:\n            test: ping -c 1 www.google.com || exit 1\n            interval: 1m\n            timeout: 10s\n            retries: 1\n        cap_add:\n            - NET_ADMIN\n        devices:\n            - /dev/net/tun\n        ports:\n            - 6089:6089\n            - 6881:6881\n            - 6881:6881/udp\n    qbittorrent:\n        image: linuxserver/qbittorrent:latest\n        container_name: qbittorrent\n        environment:\n            - PUID=0\n            - PGID=0\n            - TZ=Asia/Seoul\n        volumes:\n            - ./config:/config\n            - ./downloads:/downloads\n        devices:\n            - /dev/fuse:/dev/fuse:rwm\n        cap_add:\n            - SYS_ADMIN\n        depends_on:\n            - adguard-vpn-cli\n        network_mode: service:adguard-vpn-cli\n```\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n## Prerequisites\n\n| Variable                               | Description                                                                                                                                      | Default value | Allow values             |\n| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | ------------- | ------------------------ |\n| ADGUARD_USERNAME                       | Username for login                                                                                                                               | \"username\"    |                          |\n| ADGUARD_PASSWORD                       | Password for login                                                                                                                               | \"password\"    |                          |\n| ADGUARD_CONNECTION_LOCATION            | Defaults to the last used location                                                                                                               | \"JP\"          |                          |\n| ADGUARD_CONNECTION_TYPE                | Set VPN operating mode                                                                                                                           | \"TUN\"         | TUN / SOCKS              |\n| ADGUARD_SOCKS5_USERNAME                | Set the SOCKS username                                                                                                                           | \"username\"    |                          |\n| ADGUARD_SOCKS5_PASSWORD                | Set the SOCKS password                                                                                                                           | \"password\"    |                          |\n| ADGUARD_SOCKS5_HOST                    | Set the SOCKS listen host.                                                                                                                       | \"127.0.0.1\"   |                          |\n| ADGUARD_SOCKS5_PORT                    | Set the SOCKS port                                                                                                                               | 1080          |                          |\n| ADGUARD_SEND_REPORTS                   | Send crash reports to developers                                                                                                                 | false         | true / false             |\n| ADGUARD_SET_SYSTEM_DNS                 | Set the system DNS servers                                                                                                                       | false         | true / false             |\n| ADGUARD_USE_CUSTOM_DNS                 | Use the custom DNS servers                                                                                                                       | true          | true / false             |\n| ADGUARD_CUSTOM_DNS                     | Set the DNS upstream server                                                                                                                      | \"1.1.1.1\"     |                          |\n| ADGUARD_USE_KILL_SWITCH                | Use the Kill Switch                                                                                                                              | true          | true / false             |\n| ADGUARD_USE_KILL_SWITCH_CHECK_INTERVAL | Check interval for Kill Switch                                                                                                                   | 30            |                          |\n| ADGUARD_UPDATE_CHANNEL                 | Set update channel                                                                                                                               | \"release\"     | release / beta / nightly |\n| ADGUARD_SHOW_HINTS                     | Show hints after command execution                                                                                                               | \"on\"          | on / off                 |\n| ADGUARD_DEBUG_LOGGING                  | Set debug logging                                                                                                                                | \"on\"          | on / off                 |\n| ADGUARD_SHOW_NOTIFICATIONS             | Get notified about the status of the VPN connection                                                                                              | \"on\"          | on / off                 |\n| ADGUARD_PROTOCOL                       | Set the protocol used by AdGuard VPN                                                                                                             | \"auto\"        | auto / http2 / quic      |\n| ADGUARD_POST_QUANTUM                   | Set whether to use advanced cryptographic algorithms resistant to quantum computer attacks to protect your traffic from potential future threats | \"off\"         | on / off                 |\n| ADGUARD_TELEMETRY                      | Set whether to send anonymized usage data to developers                                                                                          | false         | true / false             |\n| ADGUARD_TUN_ROUTING_MODE               | Set VPN tunnel routing mode                                                                                                                      | \"AUTO\"        | AUTO / SCRIPT / NONE     |\n| ADGUARD_BOUND_IF_OVERRIDE              | Override network interface to use for outbound VPN traffic (pass \"\" to disable)                                                                  | \"\"            | interface name or \"\"     |\n| ✨ADGUARD_MAX_LEAK_TOLERANCE           | Termination on first leak (0 = immediate termination on first leak)                                                                              | 0             |                          |\n| ✨ADGUARD_LEAK_WARNING_ONLY            | When a leak, only an warning (true = warning only, false = terminate)                                                                            | false         | true / false             |\n| ✨ADGUARD_MAX_IP_DETECTION_RETRIES     | Maximum number of IP detection attempts                                                                                                          | 3             | number                   |\n| ✨ADGUARD_IP_DETECTION_RETRY_DELAY     | IP detection retry delay Seconds                                                                                                                 | 10            | number                   |\n\n\u003e [!IMPORTANT] \n\u003e - `ADGUARD_SOCKS5_HOST`: For non-localhost addresses, you need to protect the proxy with a username and password.\n\u003e - `ADGUARD_USE_KILL_SWITCH_CHECK_INTERVAL`: A very short check interval is not recommended.\n\u003e - **Authentication Variables**: `ADGUARD_USERNAME` and `ADGUARD_PASSWORD` are no longer used for authentication as of version 1.5.10. Authentication is now done via web-based flow. These variables are kept for backward compatibility in other configuration aspects.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n## Location\n\nPlease check the location and add the city, country or ISO code to `ADGUARD_CONNECTION_LOCATION`\n\n| ISO | Country        | City           |\n| :-- | :------------- | :------------- |\n| AE  | UAE            | Dubai          |\n| AR  | Argentina      | Buenos Aires   |\n| AT  | Austria        | Vienna         |\n| AU  | Australia      | Sydney         |\n| BE  | Belgium        | Brussels       |\n| BG  | Bulgaria       | Sofia          |\n| BR  | Brazil         | São Paulo      |\n| CA  | Canada         | Vancouver      |\n| CA  | Canada         | Montreal       |\n| CA  | Canada         | Toronto        |\n| CH  | Switzerland    | Zurich         |\n| CL  | Chile          | Santiago       |\n| CN  | China          | Shanghai       |\n| CO  | Colombia       | Bogota         |\n| CY  | Cyprus         | Nicosia        |\n| CZ  | Czechia        | Prague         |\n| DE  | Germany        | Berlin         |\n| DE  | Germany        | Frankfurt      |\n| DK  | Denmark        | Copenhagen     |\n| EE  | Estonia        | Tallinn        |\n| EG  | Egypt          | Cairo          |\n| ES  | Spain          | Barcelona      |\n| ES  | Spain          | Madrid         |\n| FI  | Finland        | Helsinki       |\n| FR  | France         | Paris          |\n| FR  | France         | Marseille      |\n| GB  | United Kingdom | Manchester     |\n| GB  | United Kingdom | London         |\n| GR  | Greece         | Athens         |\n| HK  | Hong Kong      | Hong Kong      |\n| HR  | Croatia        | Zagreb         |\n| HU  | Hungary        | Budapest       |\n| ID  | Indonesia      | Jakarta        |\n| IE  | Ireland        | Dublin         |\n| IL  | Israel         | Tel Aviv       |\n| IN  | India          | Mumbai         |\n| IR  | Iran           | Tehran         |\n| IS  | Iceland        | Reykjavik      |\n| IT  | Italy          | Rome           |\n| IT  | Italy          | Milan          |\n| IT  | Italy          | Palermo        |\n| JP  | Japan          | Tokyo          |\n| KH  | Cambodia       | Phnom Penh     |\n| KR  | South Korea    | Seoul          |\n| KZ  | Kazakhstan     | Astana         |\n| LT  | Lithuania      | Vilnius        |\n| LU  | Luxembourg     | Luxembourg     |\n| LV  | Latvia         | Riga           |\n| MD  | Moldova        | Chișinău       |\n| MX  | Mexico         | Mexico City    |\n| NG  | Nigeria        | Lagos          |\n| NL  | Netherlands    | Amsterdam      |\n| NO  | Norway         | Oslo           |\n| NP  | Nepal          | Kathmandu      |\n| NZ  | New Zealand    | Auckland       |\n| PE  | Peru           | Lima           |\n| PH  | Philippines    | Manila         |\n| PL  | Poland         | Warsaw         |\n| PT  | Portugal       | Lisbon         |\n| RO  | Romania        | Bucharest      |\n| RS  | Serbia         | Belgrade       |\n| RU  | Russia         | Moscow         |\n| SE  | Sweden         | Stockholm      |\n| SG  | Singapore      | Singapore      |\n| SK  | Slovakia       | Bratislava     |\n| TH  | Thailand       | Bangkok        |\n| TR  | Turkey         | Istanbul       |\n| TW  | Taiwan         | Taipei         |\n| UA  | Ukraine        | Kyiv           |\n| US  | United States  | Seattle        |\n| US  | United States  | Silicon Valley |\n| US  | United States  | Phoenix        |\n| US  | United States  | Las Vegas      |\n| US  | United States  | Denver         |\n| US  | United States  | Dallas         |\n| US  | United States  | Los Angeles    |\n| US  | United States  | Atlanta        |\n| US  | United States  | New York       |\n| US  | United States  | Miami          |\n| US  | United States  | Boston         |\n| US  | United States  | Chicago        |\n| VN  | Vietnam        | Hanoi          |\n| ZA  | South Africa   | Johannesburg   |\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\u003c!-- ACKNOWLEDGMENTS --\u003e\n\n## References\n\n-   [AdguardTeam/AdGuardVPNCLI](https://github.com/AdguardTeam/AdGuardVPNCLI)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- MARKDOWN LINKS \u0026 IMAGES --\u003e\n\u003c!-- https://www.markdownguide.org/basic-syntax/#reference-style-links --\u003e\n\n[contributors-shield]: https://img.shields.io/github/contributors/supersunho/docker-adguardvpn-cli.svg?style=for-the-badge\n[contributors-url]: https://github.com/supersunho/docker-adguardvpn-cli/graphs/contributors\n[forks-shield]: https://img.shields.io/github/forks/supersunho/docker-adguardvpn-cli.svg?style=for-the-badge\n[forks-url]: https://github.com/supersunho/docker-adguardvpn-cli/network/members\n[stars-shield]: https://img.shields.io/github/stars/supersunho/docker-adguardvpn-cli.svg?style=for-the-badge\n[stars-url]: https://github.com/supersunho/docker-adguardvpn-cli/stargazers\n[issues-shield]: https://img.shields.io/github/issues/supersunho/docker-adguardvpn-cli.svg?style=for-the-badge\n[issues-url]: https://github.com/supersunho/docker-adguardvpn-cli/issues\n[license-shield]: https://img.shields.io/github/license/supersunho/docker-adguardvpn-cli.svg?style=for-the-badge\n[license-url]: https://github.com/supersunho/docker-adguardvpn-cli/blob/master/LICENSE.txt\n[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge\u0026logo=linkedin\u0026colorB=555\n[linkedin-url]: https://linkedin.com/in/supersunho\n[product-screenshot]: images/screenshot.png\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsupersunho%2Fdocker-adguardvpn-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsupersunho%2Fdocker-adguardvpn-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsupersunho%2Fdocker-adguardvpn-cli/lists"}