RiseupVPN for Linux


To use Riseup’s VPN service, you will need to install the program called RiseupVPN. On Linux, it is available either as a snap, or as a package in Debian Stable.

RiseupVPN is currently tested on the Ubuntu LTS and Debian Stable. If you have a different release, it may or may not work.

Snap Installation

If you use Ubuntu, snap is already installed. Otherwise, run:

sudo apt install snapd

Then, simply search for RiseupVPN in the Software Center or click on this link:

Open RiseupVPN in Software Center

If the link above does not work for you, you can also install via the command line:

sudo snap install --classic riseup-vpn

If you get an error stating that “python” is missing from /usr/bin/env, you need to install python. This is the case for instance in Lubuntu, at least since version 19.04.

Package Installation

   echo "deb http://deb.leap.se/client release buster" | sudo tee -a /etc/apt/sources.list.d/leap.list
   curl https://deb.leap.se/apt.key | sudo apt-key add -
   sudo apt-get update
   sudo apt-get install riseup-vpn leap-archive-keyring


Bug Reports and Feature Requests

RiseupVPN is built using a free software program called bitmask-vpn.

Step 1: Search to see if the bug has already been reported.

Step 2: Register an account with 0xacab.org and log in.

Step 3: Create a new bug report or feature request.

Please include the following information in your bug report:

  • Steps to reproduce the bug
  • What is the expected behaviour and what do you see
  • A screenshot if it is something visual
  • Your linux distribution and its version
  • The log of the program

Get the logs

The log of RiseupVPN is located in your home folder:


When reporting a bug it is very useful to include the log file.

Force quit

If anything stops working, run these commands and then try again:

sudo pkill -e -f riseup-vpn
sudo /snap/bin/riseup-vpn.bitmask-root firewall stop
test -f ~/.config/leap/systray.pid && rm -v ~/.config/leap/systray.pid

These commands will ensure that all RiseupVPN processes are killed, the egress firewall rules are removed, and the PID file is cleaned up.

Won’t start

If the launcher icon does not work, you can run RiseupVPN from the command line in order to identify the problem:


Any problem starting will be displayed on the terminal.

Test a pre-release version

If you want to help us test a development, pre-release version of RiseupVPN, you can install it using this command:

sudo snap install --classic --beta riseup-vpn

Remove PID file

Sometimes RiseupVPN will fail to start if it thinks another version is already running.

If you get this error, run these commands:

sudo pkill -e -f riseup-vpn
test -f ~/.config/leap/systray.pid && rm -v ~/.config/leap/systray.pid