.. _librem_one_pureos_vpn:

.. _liberty_services_pureos_vpn:

Librem Tunnel
=============

Install Librem Tunnel in PureOS
-------------------------------

1. Verify that the pre-requisite package ``network-manager-openvpn-gnome`` is installed.

  * Open a terminal window and run the command ``dpkg -l network-manager-openvpn-gnome``. The output will contain the text ``ii  network-manager-openvpn-gnome`` if already installed.
  * If it is not installed, run the command ``sudo apt install -y network-manager-openvpn-gnome`` to install it.

2. Verify that the Librem Tunnel service is activated.

  * Visit `<https://librem.one/accounts/profile/>`_
  * Log in to your account
  * Activate the *tunnel service* if not already active

3. Retrieve your Librem Tunnel credentials and *.ovpn* file. See: :ref:`librem_one_generic`

4. Open *Settings* → *Network*. Under the *VPN* category, click the **"+"** button to add new connection, then select **Import from file...**:

.. image:: img/LibremTunnel/Tunnel_PureOS_01.png
  :alt: import conn

5. Select the *.ovpn* file and click the **"Open"** button. An *Add VPN* dialog window will appear. Enter the Librem Tunnel credentials (*Username* and *Password*) in step 3 and click the **"Add"** button:

.. image:: img/LibremTunnel/Tunnel_PureOS_02.png
  :alt: add new vpn conn

Connect Librem Tunnel
---------------------

1. Click on the right side of the top bar in PureOS
2. Select the option **"VPN Off"**
3. Select **"Connect"**

.. image:: img/LibremTunnel/Tunnel_PureOS_03.png
  :alt: Librem Tunnel Connect

A padlock symbol on the right side of the top bar indicates that Librem Tunnel is connected.

.. image:: img/LibremTunnel/Tunnel_PureOS_04.png
  :alt: Librem padlock

To verify that Librem Tunnel is connected, open PureBrowser and search for the term **"ip"**, before you connect Librem Tunnel:

.. image:: img/LibremTunnel/Tunnel_PureOS_05.png
  :alt: IP before Librem tunnel

Performing the same search after Librem Tunnel is connected:

.. image:: img/LibremTunnel/Tunnel_PureOS_06.png
  :alt: IP after Librem tunnel

Disconnect Librem Tunnel
------------------------

1. Click on the right side of the top bar in PureOS
2. Select your Librem Tunnel VPN option
3. Select **"Turn Off"**

.. image:: img/LibremTunnel/Tunnel_PureOS_07.png
  :alt: IP after Librem tunnel