Introduction

There are two ways to install Bitmask on Linux, as a package or as a stand-alone bundle.

• Packages: run faster, and are better integrated with the desktop environment.
• Bundles: do not require root, and can be installed on a portable thumb drive.

To find out which distribution you are running, open a terminal and type in the following:

cat /etc/issue

Ubuntu Packages

Ubuntu 16.04 LTS (Xenial Xerus)

To install

sudo -s
add-apt-repository "deb http://deb.bitmask.net/debian xenial main"
wget -O- https://dl.bitmask.net/apt.key | apt-key add -
apt update
apt install bitmask leap-archive-keyring

To remove

sudo -s
apt remove bitmask leap-archive-keyring
apt-key del 0x1E34A1828E207901
add-apt-repository --remove "deb http://deb.bitmask.net/debian xenial main"

When upgrading to this OS

sudo -s
add-apt-repository --remove "deb http://deb.bitmask.net/debian wily main"
add-apt-repository "deb http://deb.bitmask.net/debian xenial main"
apt update
apt upgrade

Ubuntu 15.10 (Wily Werewolf)

To install

sudo -s
add-apt-repository "deb http://deb.bitmask.net/debian wily main"
wget -O- https://dl.bitmask.net/apt.key | apt-key add -
apt update
apt install bitmask leap-archive-keyring

To remove

sudo -s
apt remove bitmask leap-archive-keyring
apt-key del 0x1E34A1828E207901
add-apt-repository --remove "deb http://deb.bitmask.net/debian wily main"

When upgrading to this OS

sudo -s
add-apt-repository --remove "deb http://deb.bitmask.net/debian vivid main"
add-apt-repository "deb http://deb.bitmask.net/debian wily main"
apt update
apt upgrade

Ubuntu 15.04 (Vivid Vervet)

To install

sudo -s
add-apt-repository "deb http://deb.bitmask.net/debian vivid main"
wget -O- https://dl.bitmask.net/apt.key | apt-key add -
apt update
apt install bitmask leap-archive-keyring

To remove

sudo -s
apt remove bitmask leap-archive-keyring
apt-key del 0x1E34A1828E207901
add-apt-repository --remove "deb http://deb.bitmask.net/debian vivid main"

When upgrading to this OS

sudo -s
add-apt-repository --remove "deb http://deb.bitmask.net/debian utopic main"
add-apt-repository "deb http://deb.bitmask.net/debian vivid main"
apt update
apt upgrade

Debian Packages

If you are using Wheezy, then you will need to use the bundle method.

Debian 8 (Stable/Jessie)

To install

sudo -s
echo "deb http://deb.bitmask.net/debian jessie main" > /etc/apt/sources.list.d/bitmask.list
wget -O- https://dl.bitmask.net/apt.key | apt-key add -
apt update
apt install bitmask leap-archive-keyring

To remove

sudo -s
apt remove bitmask leap-archive-keyring
apt-key del 0x1E34A1828E207901
rm /etc/apt/sources.list.d/bitmask.list

When upgrading to this OS

sudo -s
echo "deb http://deb.bitmask.net/debian jessie main" > /etc/apt/sources.list.d/bitmask.list
apt update
apt upgrade

Debian Testing (Stretch)

To install

sudo -s
echo "deb http://deb.bitmask.net/debian testing main" > /etc/apt/sources.list.d/bitmask.list
wget -O- https://dl.bitmask.net/apt.key | apt-key add -
apt update
apt install bitmask leap-archive-keyring

To remove

sudo -s
apt remove bitmask leap-archive-keyring
apt-key del 0x1E34A1828E207901
rm /etc/apt/sources.list.d/bitmask.list

When upgrading to this OS

sudo -s
echo "deb http://deb.bitmask.net/debian testing main" > /etc/apt/sources.list.d/bitmask.list
apt update
apt upgrade

Debian Unstable (Sid)

To install

sudo -s
echo "deb http://deb.bitmask.net/debian sid main" > /etc/apt/sources.list.d/bitmask.list
wget -O- https://dl.bitmask.net/apt.key | apt-key add -
apt update
apt install bitmask leap-archive-keyring

To remove

sudo -s
apt remove bitmask leap-archive-keyring
apt-key del 0x1E34A1828E207901
rm /etc/apt/sources.list.d/bitmask.list

When upgrading to this OS

sudo -s
echo "deb http://deb.bitmask.net/debian sid main" > /etc/apt/sources.list.d/bitmask.list
apt update
apt upgrade

Stand Alone Bundle

The Bitmask stand alone bundle should work on most recent versions of Debian and Ubuntu. You are welcome to try the bundle on other distributions, it sometimes works. Alternately, you can build it from source.

First determine if you running a 32 bit or 64 bit kernel by running the following command:

uname -m

If the result is x86_64, you have 64 bit	Download 64 bit	Signature file
If the result is: i686 or i386, you have 32 bit	Download 32 bit	Signature file

Optionally, you can authenticate the signature using LEAP’s archive signing key.

If you want to try an experimental or release candidate versions of Bitmask, you can browse the full list of available downloads.

Upgrading

From stand-alone bundles: Bitmask should upgrade itself automatically (for versions equal or later than 0.7.0). If you are running a version prior to 0.7.0, you can download the new bundle and copy the “config” folder from the old bundle directory.

From packages: If you are running from packages, then you can trigger an update like so:

apt-get update
apt-get dist-upgrade

NOTE: When upgrading the version of your operating system, you must also follow the directions listed under “When upgrading the OS” above.