Installation¶

The Desktop client only works on Linux. Python 3.6+ is required. It is recommended to use a deb or rpm package to install the eduVPN client. You can also install using pip from pypi or directly from Github. We distribute RPM packages for Fedora, and deb packages for Debian and Ubuntu.

The eduVPN client has been tested with:

Debian 11 (Bullseye)

Ubuntu 22.04 LTS

Fedora 36 and 37

Note

If your target is not supported you can make an issue on the GitHub and we will see if we can provide it. Right now we only provide x86_64 packages (we use a compiled dependency), if you want an ARM package for a certain target you can also make an issue.

Debian (11) and Ubuntu (22.04 & 22.10)¶

$ sudo apt install apt-transport-https lsb-release wget
$ wget -O- https://app.eduvpn.org/linux/v4/deb/app+linux@eduvpn.org.asc | gpg --dearmor | sudo tee /usr/share/keyrings/eduvpn-v4.gpg >/dev/null
$ echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/eduvpn-v4.gpg] https://app.eduvpn.org/linux/v4/deb/ $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/eduvpn-v4.list
$ sudo apt update
$ sudo apt install eduvpn-client

Fedora (36 & 37)¶

$ curl -O https://app.eduvpn.org/linux/v4/rpm/app+linux@eduvpn.org.asc
$ sudo rpm --import app+linux@eduvpn.org.asc
$ cat << 'EOF' | sudo tee /etc/yum.repos.d/python-eduvpn-client_v4.repo
[python-eduvpn-client_v4]
name=eduVPN for Linux 4.x (Fedora $releasever)
baseurl=https://app.eduvpn.org/linux/v4/rpm/fedora-$releasever-$basearch
gpgcheck=1
EOF
$ sudo dnf install eduvpn-client

CentOS (Stream 9)¶

$ curl -O https://app.eduvpn.org/linux/v4/rpm/app+linux@eduvpn.org.asc
$ sudo rpm --import app+linux@eduvpn.org.asc
$ cat << 'EOF' | sudo tee /etc/yum.repos.d/python-eduvpn-client_v4.repo
[python-eduvpn-client_v4]
name=eduVPN for Linux 4.x (CentOS Stream 9)
baseurl=https://app.eduvpn.org/linux/v4/rpm/centos-stream+epel-next-9-$basearch
gpgcheck=1
EOF
$ sudo dnf install eduvpn-client

Arch (Unofficial)¶

There is an unofficial package in the Arch User Repository (AUR).

Manual source installation¶

Dependencies¶

To manually install the eduVPN package you first need to satisfy the build requirements.

For Debian or Ubuntu:

$ sudo apt install build-essential git make

For Fedora:

$ sudo dnf install git make

For Debian or Ubuntu we made a make target to install the required debian packages:

$ sudo make deb

For Fedora we did the same:

$ sudo make dnf

You can then continue with installing via e.g. Pip

If you’re not installing the rest via Pip, note that since version 4 of this Linux client, we use the eduvpn-common Go library to provide most of the core functionality. Thus these commands cannot provide you the complete development dependencies as eduvpn-common is not in the official repositories. To install this library manually and to see how it works we refer to their documentation.

Eduvpn-common, however is available to install with Pip (it includes precompiled shared libraries). The aforementioned repositories (e.g. Fedora, Debian) also include the latest stable release of eduvpn-common.

Development packages for eduvpn-common and this client will follow later.

Pip¶

You can install the client API from pypi:

$ pip install "eduvpn-client[gui]"

Or, if you want to try out the bleeding edge development version:

$ pip install git+https://github.com/eduvpn/python-eduvpn-client.git

Note

This requires the installation of system packages using your distributions package manager. See the previous section for the Makefile targets for your system.

Development version¶

You first need to obtain the code:

$ git clone https://github.com/eduvpn/python-eduvpn-client.git
$ cd python-eduvpn-client

We’ve made various Makefile targets to quickly get started. For example to start the eduVPN GUI:

$ make eduvpn-gui

Please have a look in the Makefile to find out the available targets.

Issues¶

If you experience any issues you could and should report them at our issue tracker. Please don’t forget to mention your OS, method of installation, eduVPN client version and instructions on how to reproduce the problem. If you have a problem enabling your VPN connection please also examine the journalctl -u NetworkManager logs. The log file of the eduVPN app can also help us figure out the problem, running the gui or cli in debug mode (-d) flag will print debug logging to the log file located at: ~/.config/eduvpn/log or ~/.config/letsconnect/log for Let’s Connect!.

Source code¶

Development of this project takes place on github. You can find the source code and all releases there.

Contributing¶

Contributions are more than welcome! If you experience any problems let us know in the bug tracker. We accept patches in the form of github pull requests. Please make sure your code works with python3 and is pycodestyle (formerly pep8) compatible. Also make sure the test suite actually passes all tests. Translations are also welcome!