🔒 A golang implementation of the Bitmask VPN client, displaying a systray icon as a state indicator and control. https://bitmask.net
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
kali kaneko (leap communications) eedc47336e
[i18n] update locales
1 day ago
branding [pkg] improve osx installer 5 days ago
cmd/bitmask-helper [pkg] windows helper and qtinstaller 5 months ago
debian [pkg] skip dwz to be able to build in buster 1 day ago
docker [pkg] add build deps 3 weeks ago
docs [docs] blank lines needed 5 days ago
gui [i18n] update locales 1 day ago
helpers [feat] bitmask-root: search for the system commands in the common paths 11 months ago
pkg [pkg] relax reflect 1.14 requirement 1 day ago
providers [pkg] add installer logo 3 months ago
tests [pkg] put desktop place in gui folder for snaps 4 months ago
.gitignore Updating makefile to support Cygwin64 for Windows users. 3 months ago
.gitlab-ci.yml [pkg] build debian package 2 weeks ago
AUTHORS [docs] add AUTHORS file 3 months ago
LICENSE [doc] add copyright notice 3 years ago
Makefile [pkg] improve osx installer 5 days ago
README.md https not http 1 week ago
bitmask.pro [pkg] add notarization steps for installer in osx 3 months ago
code-of-conduct.txt [docs] add copy of code of conduct 4 months ago
go.mod [pkg] go mod tidy 5 months ago
go.sum [pkg] go mod tidy 5 months ago
test.pro [test] update ui smoke test, add it to ci 5 months ago



Clone this repo, install dependencies and build the application. Dependencies assume debian packages, or homebrew for osx. For Windows OS see corresponding section below. For other systems try manually, or send us a patch.

  git clone git@0xacab.org:leap/bitmask-vpn.git && cd bitmask-vpn
  sudo make depends
  make build

You need at least go 1.11.

If you have Ubuntu Bionic/18.04, the package in the repositories is too old. To resolve this, you can do make install_go. Do not do this if you have a later version.

For other situations, have a look at https://github.com/golang/go/wiki#working-with-go


You can run some tests too.

  sudo apt install qml-module-qttest
  make test
  make test_ui


As for now app can be build on Win OS using Cygwin terminal.


You need to have installed and added to your user PATH (mentioned version tested in Win10):

  1. Go (>= go1.15.4)
  2. QT (>= Qt5.12.9)
  3. QtIFW (>= QtIFW-4.0.0)
  4. Cygwin64 (>= 2.905 64 bit)
  5. Using Cygwin Package Select window install python3 and make packages.

Note: for #5 you don't need to add packages to PATH they will available in cygwin after installation.

Get Source

    git clone git@0xacab.org:leap/bitmask-vpn.git && cd bitmask-vpn


Build script uses a symbolic link in one of the stages. Unfortunately Cygwin can't create native symlink from local non
admin user due to windows security restriction. To avoid this issue we need to call next target from cygwin terminal as
Administrator. This need to be done only once.

    make relink_vendor

After relink_vendor use this to build the app:

    make build

After successful build application will be available at: build/qt/release/riseup-vpn.exe


To run tests:

    make test
    make test_ui


We use transifex to coordinate translations. Any help is welcome!

Bugs? Crashes? UI feedback? Any other suggestions or complains?

When you are willing to report an issue please use the search tool first. if you cannot find your issue, please make sure to include the following information:

  • the platform you're using and the installation method.
  • the version of the program. You can check the version on the "about" menu.
  • what you expected to see.
  • what you got instead.
  • the logs of the program. The location of the logs depends on the OS:
    • gnu/linux: /home/<your user>/.config/leap/systray.log
    • OSX: /Users/<your user>/Library/Preferences/leap/systray.log, /Applications/RiseupVPN.app/Contents/helper/helper.log & /Applications/RiseupVPN.app/Contents/helper/openvpn.log
    • windows: C:\Users\<your user>\AppData\Local\leap\systray.log, C:\Program Files\RiseupVPN\helper.log & C:\Program Files\RiseupVPN\openvp.log