1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
|
RiseupVPN
=========
Anonymous VPN. Easy, fast, secure.
This repo has everything needed to build BitmaskLite/RiseupVPN on different platforms
(windows, mac and linux).
RiseupVPN is a branded build of Bitmask Lite. Bitmask Lite is a minimal rewrite of the Bitmask VPN Client, written in golang, that for now lacks client authentication, and is preconfigured to use a single provider. As of this moment, it is built for a single provider (riseup.net), but it should be easy to customize for other providers.
Install
------------
Linux
~~~~~
For GNU/Linux, RiseupVPN is distributed using snap. You can get the stable version of the snap from the `snap store` if you're using Gnome Software, that has desktop integration for snaps. Otherwise, you can use the terminal::
sudo apt install snapd
sudo snap install riseup-vpn --classic
After that, you *should* have a RiseupVPN entry in your menu. You can also launch the snap from a terminal::
snap run riseup-vpn
Testing other releases of the snap under Linux
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
To install a snap published on a specific channel, indicate it from the commandline::
sudo snap install riseup-vpn --classic --candidate
sudo snap install riseup-vpn --classic --beta
sudo snap install riseup-vpn --classic --edge
The beta channel has four daily builds of whatever is in the master branch, for amd64 and i686. The edge channel usually contains fixes that we push to be tested individually.
If you are installing a local build of the snap, you need to add the ``--dangerous`` flag::
sudo snap install riseupvpn --dangerous --classic riseup-vpn*.snap
Windows
~~~~~~~
We build a windows installer for RiseupVPN, using nsis. For testing, you can find the `snap artifact`_ for the latest build in the master branch in the CI. We publish the `latest stable windows installer`_, as well as `windows pre-releases`_.
.. _`snap artifact`: https://0xacab.org/leap/bitmask-systray/-/jobs/artifacts/master/download?job=win_installer
.. _`latest stable windows installer`: https://downloads.leap.se/RiseupVPN/windows/RiseupVPN-win-latest.exe
.. _`windows pre-releases`: https://downloads.leap.se/RiseupVPN/windows/beta/
OSX
~~~
For OSX there is also a `.pkg` installer. You can always get the `latest stable OSX installer`_, as well as `osx pre-releases`_.
.. _`latest stable OSX installer`: https://downloads.leap.se/RiseupVPN/osx/RiseupVPN-OSX-latest.pkg
.. _`osx pre-releases`: https://downloads.leap.se/RiseupVPN/osx/beta/
Bugs
------------
You can report issues in `our bug tracker`_.
.. _`our bug tracker`: https://0xacab.org/leap/riseup_vpn/issues
Build
------------
If you want to build RiseupVPN yourself, get all prerequisites, using your system's package manager if you wish::
* golang
* make
* python3
Snap
~~~~
You can build a local version of the snap::
make build_snap
OSX
~~~
To build RiseupVPN in OSX::
make build_osx
Windows builds
~~~~~~~~~~~~~~
In *windows* there are a couple of extra dependencies. We recommend using chocolatey to get them::
* nsis
* nssm
You can do a native build in windows::
make deps_win
make openvpn_win
make build_win
You can also cross-compile openvpn::
# TODO - modify to build statically and with polarssl.
apt install gcc-mingw-w64-x86-64
git clone https://github.com/OpenVPN/openvpn-build
cd openvpn-build/windows-nsis
CHOST=x86_64-w64-mingw32 CBUILD=i686-pc-cygwin ./build
|