Fast, flexible and reliable VPN extension for browsers

Your online safety and anonymity guaranteed by a trusted developer.

Website | Reddit | Twitter | Telegram

AdGuard VPN serves to protect your online privacy, encrypt your connection, hide your IP address and websites you visit from anyone (including your Internet provider) and to ensure anonymous browsing on the web. Cutting edge technologies and multiple customization options will help conceal your location and unblock geographically restricted websites or other content.

To get more information and to download AdGuard VPN visit our website https://adguard-vpn.com/.

Feedback options

We appreciate your feedback and always welcome both constructive critisism and new ideas.

You can use GitHub to report a bug or to submit a feature request. To do so, go to this page, click the New issue button and choose between creating a bug report or feature request.

• Development
  • Build
  • Linting
  • Tests
  • Localization
  • Proto scheme update
• Acknowledgments
• Minimum supported browser versions

Development

Build

• yarn install
• Rename .env.example to .env and fill it with required config data
• yarn dev / yarn beta / yarn release
• Also, you can provide environment variables through command line like this:

STAGE_ENV=test \
VPN_API_URL="vpn_api_url" \
AUTH_API_URL="auth_api_url" \
WEBSITE_DOMAIN="website_domain" \
yarn dev

Builds will be located in the build directory

Artifact builds

• CREDENTIALS_PASSWORD=<password> artifacts:beta
• CREDENTIALS_PASSWORD=<password> artifacts:release

Make sure you have added credentials

• certificate-beta.pem - chrome crx beta certificate
• certificate-release.pem - chrome crx release certificate
• mozilla_credentials.json - encrypted credentials,

to the directory ./private/AdguardVPN

Linting

• yarn lint

Tests

• yarn test

Localization

• setup your project locales, directories in the file tasks/locales.js
• yarn locales:upload used to upload base en locale
• yarn locales:download run to download and save all locales
• yarn locales:validate used to validate locales

Proto scheme update

After every update of proto scheme in the file src/background/connectivity/connectivity.proto, you have to run yarn compile-proto. This command will update module src/background/connectivity/protobufCompiled.js used to build messages with appropriate scheme for websocket messaging.

Acknowledgments

This software wouldn't have been possible without:

• React
• MobX
• Babel
• Jest
• and many more npm packages.

For a full list of all npm packages in use, please take a look at package.json file.

Minimum supported browser versions

Browser	Version
Chromium Based Browsers	66
Firefox	60