WireGuard on SailfishOS

How to use WireGuard VPNs on SailfishOS. Tutorials for various VPN providers

Installing WireGuard

Install necessary tools 

SailfishOS doesn't provide WireGuard functionality out-of-the-box, so we first need to install a few third-party programs from OpenRepos. You can get all of these either by downloading the RPMs manually from openrepos.net or by using Storeman.

Wireguard userspace implementation

Install the package wireguard-go : Download from OpenRepos

Wireguard userspace tools

Install the package wireguard-tools : Download from OpenRepos

Connman plugin for integrating Wireguard into Sailfish network manager

Install the package "WireGuard for Sailfish (connman plugin)" (connman-plugin-vpn-wireguard): Download from OpenRepos

VPN plugin for Sailfish OS settings app

Install the package "WireGuard for Sailfish (Settings UI)" (jolla-settings-networking-plugin-vpn-wireguard): Download from OpenRepos
This plugin is optional but makes using WireGuard much easier.

 

[EXAMPLE]: Using WireGuard with MullvadVPN

Step 1: Obtain a WireGuard config file from Mullvad

To get a config file, head over to https://mullvad.net/de/account/wireguard-config (you will need to login with your account number). 
1. For the "platform" select "Linux".

2.Next, click on "Generate key" (or something like that in your language).

grafik.png

3. Select a country 

4. Select a city for your country

5. For the "Tunnel traffic", choose "Only IPv4"

6. Click on "Download file". You will get a .conf-file.

grafik.png

7. Copy the file to the storage of your SailfishOS-device

Step 2: Importing the file on Sailfish

  1. Open the settings-app and navigate to "VPN"
  2. In the pull-down menu, choose "Add new VPN"
  3. Choose "WireGuard" for the VPN-Type (typically located at the bottom of the list)
  4. On the next page, choose to import a "wg-quick.conf" file.
  5. A file-chooser-dialog will open. Choose the .conf-file we downloaded earlier.
  6. The setup will tell you that the import was successful. Now you just need to give the VPN a name.
  7. I recommend to choose "Remember login credentials" (or something like that in your language) under the "Advanced"-settings
  8.  You can now select the VPN in the list to connect to it.
    NOTE: If SailfishOS asks for credentials to login, the username is your account number and the password is just the letter "m"

Needing help?

If you run into troubles, feel free to ask for help here