f1eb44468229a1fcfca85f0faaa45804e82d0e7b
[dl_bitmask_net.git] / pages / linux / en.md
1 @title = 'Bitmask for GNU/Linux'
2 @nav_title = 'Linux'
3
4 <%= render({:partial => 'common/notice'}, {:type => 'info', :text => '<b>NOTE:</b> Encrypted email support in Bitmask is still experimental.'}) %>
5
6 # Introduction
7
8 There are two ways to install Bitmask on Linux, as a **package** or as a stand-alone **bundle**.
9
10 * **Packages**: run faster, and are better integrated with the desktop environment.
11 * **Bundles**: do not require root, and can be installed on a portable thumb drive.
12
13 To find out which distribution you are running, open a terminal and type in the following:
14
15     cat /etc/issue
16
17 # Ubuntu Packages
18
19 ### Ubuntu 16.04 LTS (Xenial Xerus)
20
21 <%= render({:partial => 'via_packages'}, {:distro => 'xenial'}) %>
22
23 ### Ubuntu 15.10 (Wily Werewolf)
24
25 <%= render({:partial => 'via_packages'}, {:distro => 'wily'}) %>
26
27 ### Ubuntu 15.04 (Vivid Vervet)
28
29 <%= render({:partial => 'via_packages'}, {:distro => 'vivid'}) %>
30
31 # Debian Packages
32
33 If you are using Wheezy, then you will need to use the bundle method.
34
35 ### Debian 8 (Stable/Jessie)
36
37 <%= render({:partial => 'via_packages'}, {:distro => 'jessie', :os => 'debian', :backport => 'true'}) %>
38
39 ### Debian Testing (Stretch)
40
41 <%= render({:partial => 'via_packages'}, {:distro => 'testing', :os => 'debian'}) %>
42
43 ### Debian Unstable (Sid)
44
45 <%= render({:partial => 'via_packages'}, {:distro => 'sid', :os => 'debian'}) %>
46
47 # Stand Alone Bundle
48
49 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 => https://leap.se/en/docs/get-involved/source]].
50
51 Our most recent stable release is only available for a 64 bit kernel. 
52
53 <table class="table">
54 <tr><td>
55   <%= render({:partial => 'common/download_button'}, {:link => 'https://dl.bitmask.net/client/linux/stable/Bitmask-linux64-latest.tar.gz', :text => 'Download 64 bit'}) %>
56 </td><td>
57   [[Signature file => https://dl.bitmask.net/client/linux/stable/Bitmask-linux64-latest.tar.gz.asc]]
58 </td></tr>
59 </table>
60
61 Optionally, you can [[authenticate the signature => signature-verification]] using LEAP's archive signing key.
62
63 If you want to try an experimental or release candidate versions of Bitmask, you can browse the [[full list of available downloads => https://dl.bitmask.net/client/linux]].
64
65 # Upgrading
66
67 **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.
68
69 **From packages**: If you are running from packages, then you can trigger an update like so:
70
71     apt-get update
72     apt-get dist-upgrade
73
74 **NOTE:** When upgrading the version of your operating system, you must also follow the directions listed under "When upgrading the OS" above.
75
76 # Latest builds
77 For the more adventurous we make stand alone bundle builds available after each commit or merge. Currently best tested again cdev.bitmask.net, because of ongoing changes of Soledad. 
78
79   <%= render({:partial => 'common/download_button'}, {:link => 'https://0xacab.org/leap/bitmask-dev/builds/artifacts/master/download?job=bitmask_latest_bundle', :text => 'Download latest experimental bundle'}) %>