These are generic instructions for setting up a client of your own liking for Librem One services.

Librem Chat

Sign in with: email


Advanced settings

Homeserver URL:

Librem Social



Librem Mail


Authentification: normal password

  Server Port Security
Incoming 143 STARTTLS
Outgoing 587 STARTTLS


Password lenght limit for SMTP is 127 chars.

Librem Tunnel

Obtain Tunnel Credentials and *.ovpn configuration file

Other ways to setup Tunnel Tunnel uses a username and password different from the Librem One credentials. To setup Tunnel in an OpenVPN client without the ldh_client, you can:

1 - Download the profile file from here:

2 - Log in to your account at:

3 - While you are log in at:, open a new tab in your browser and go to:

And from there you can retrieve your Tunnel credentials.

Install Librem Tunnel in other GNU/Linux distributions


The Installation instructions for PureOS will work with most Debian based distributions, however there are some exceptions due to different factors. Bellow is a list of how to adjust the PureOS Tunnel instructions to some Distributions.

Ubuntu Mate / Zorin OS / Pop_OS!

Make sure the following dependencies are installed: gir1.2-nm-1.0 network-manager-openvpn network-manager-openvpn-gnome

Then follow the normal instructions at:


Install extra dependency: gir1.2-nm-1.0

Then follow the normal instructions at:

Linux Mint

Do these first to get pipx:

sudo apt-get install python3-pip

python3 -m pip install --user pipx

python3 -m userpath append ~/.local/bin

And follow the pureOS instructions but do not install pipx


Install extra dependencies:

libcairo2-dev libgirepository1.0-dev pip venv python3-pip python-pip

gir1.2-nm-1.0 network-manager-openvpn network-manager-openvpn-gnome seahorse

Run the commands: python3 -m pip install --user pipx python3 -m userpath append ~/.local/bin pip3 install ldh-client

Follow the account setup steps here:

Arch Linux

Install extra dependencies: python-gobject, python-requests Download the ldh_client at: Edit line 67 of and remove x86_64-linux-gnu/

Run the install script locally.

Then follow the account setup instructions at:

Manjaro Linux

Install extra dependencies: python-gobject, python-requests, gobject-introspection Download the ldh_client at: Edit line 67 of and remove x86_64-linux-gnu/

Run the install script locally.

Then follow the account setup instructions at:


Run the commands:

mkdir -p ~/libremonesetup cd ~/libremonesetup pipenv --python 3.7 sudo dnf install cairo-devel gobject-introspection-devel cairo-gobject-devel pipenv install ldh-client

Change line 67 in the and applied the same edit on Line 67 to remove and change /usr/lib/x86_64-linux-gnu/ to /usr/lib64 pipenv run liberty tunnel-setup

Errors that might occur when installing Tunnel in other distributions

Installing to existing directory /XXXXXXXXXXXX/.local/pipx/venvs/ldh-client File already exists It’s usually because you tried to install it before with and for some reason failed . You can delete the folder ldh-client at /home/USERNAME/.local/pipx/venvs/ldh-client and try again.

raise ValueError(‘Namespace %s not available’ % namespace) ValueError: Namespace NM not available Needs to install: gir1.2-nm-1.0

gi.repository.GLib.Error: nm-vpn-plugin-error-quark:

cannot load plugin“/usr/lib/x86_64-linux-gnu/NetworkManager/”: Needs to install: network-manager-openvpn-gnome network-manager-openvpn

Something went wrong when connecting to Problem details: Internal Server Error User tried to setup the account with``**, and in tunnel for desktop it's only:** ``username

Connects to tunnel but there is no signal Go to Network > Select Tunnel > Identity > Advanced > Security And change the cipher to: AES-128-CBC

VPN connection: failed to connect interactively: ‘Invalid HMAC auth.’ suggested the following solution: VPN Settings > Identity > Advanced > Security > HMAC Authentication: Change to Default

Network Manager asks for the password when trying to connect to Tunnel. This happens because network manager was unable to get the tunnel password from the Keyring application. If the user puts the Librem One account password when Network manager asks for this it will not connect because Tunnel uses a different password. Workarounds: in some cases installing: network-manager-openvpn-gnome and seahorse and setting up the tunnel account again worked. In other cases the workaround was installing Seahorse and from there copying the Tunnel password to use in Network Manager. (As reported by users)