.. include:: /urls.rst

.. _l1_pureos_tunnel:

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


.. _l1_pureos_tunnel_install:

Installation
------------

#. 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.

#. Verify that the Librem Tunnel service is activated.

   * Visit your `Librem One profile`_
   * Log in to your account
   * Activate the *tunnel service* if not already active

#. Retrieve your Librem Tunnel credentials and *.ovpn* file.
   See: :ref:`l1_generic`
#. Open *Settings* → *Network*.
   Under the *VPN* category, click the **"+"** button to add new connection, then select **Import from file...**:

   .. image:: /_files/l1/pureos/tunnel/Tunnel_PureOS_01.png
      :alt: import conn
      :class: no-scaled-link

#. 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:: /_files/l1/pureos/tunnel/Tunnel_PureOS_02.png
      :alt: add new vpn conn
      :class: no-scaled-link


.. _l1_pureos_tunnel_connect:

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

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

   .. image:: /_files/l1/pureos/tunnel/Tunnel_PureOS_03.png
      :alt: Librem Tunnel Connect
      :class: no-scaled-link

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

.. image:: /_files/l1/pureos/tunnel/Tunnel_PureOS_04.png
   :alt: Librem padlock
   :class: no-scaled-link

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

.. image:: /_files/l1/pureos/tunnel/Tunnel_PureOS_05.png
   :alt: IP before Librem tunnel
   :class: no-scaled-link

Performing the same search after Librem Tunnel is connected:

.. image:: /_files/l1/pureos/tunnel/Tunnel_PureOS_06.png
   :alt: IP after Librem tunnel
   :class: no-scaled-link


.. _l1_pureos_tunnel_disconnect:

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

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

   .. image:: /_files/l1/pureos/tunnel/Tunnel_PureOS_07.png
      :alt: IP after Librem tunnel
      :class: no-scaled-link