Librem Tunnel

Install Librem Tunnel in PureOS


At this moment the only way to install Librem Tunnel is with a third party source via pipx, we are working to soon being able to provide Librem Tunnel directly from our Software Centre / Repositories.


You first need to activate your tunnel, so if you haven’t do so, go to, log in and activate the tunnel service.

Open the terminal application Tilix and:

  • Run the command: sudo apt update
  • You will be asked for your PureOS user password. Type it and press enter.
Update Command
  • Run the command: sudo apt install pipx python3-venv python3-dev libcairo2-dev libgirepository1.0-dev to install the necessary dependencies.
  • You might by asked for your PureOS user password. If so type it and press enter.
  • You will be asked if you want to install these packages. Type y for yes and press enter.
Install dependencies
  • After that run the command pipx install ldh-client to install Librem Tunnel.
  • After ldh-client is installed you will see a Done message.
Install ldh-client

Configuring Librem Tunnel

After you installed the Librem Tunnel application in PureOS, open the terminal application Tilix and run the command: liberty tunnel-setup.


if the liberty command fails to run or provides an Command not found error, you can try to logout and login again and try a second time, or as a workaround use the command ./.local/bin/liberty tunnel-setup

When you run the Liberty app you will be asked first for your Librem One username. Type it and press enter, (make sure you use only username and not

Username Librem One

Then you will be asked for your Librem One account password. Type it and press enter.

Password Librem One

And Librem Tunnel is now configured in your PureOS and ready to be used.

Librem Tunnel Done

To start Librem tunnel:

  • Click on the right side of the top bar in PureOS
  • Select the option “VPN Off”
  • Select “Connect”
Librem Tunnel Connect

You will now see on the right side of the top bar a padlock symbol indicating that Librem Tunnel is working.

Librem padlock

If you want to do a test to see if Librem Tunnel is working, you can open PureBrowser and do a search for the term “ip”, before you connect Librem Tunnel:

IP before Librem tunnel

And after:

IP after Librem tunnel

To disconnect Librem Tunnel:

  • Click on the right side of the top bar in PureOS
  • Select your Librem Tunnel VPN option
  • Select “Turn Off”
IP after Librem tunnel

And that’s all.