Generic

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

Librem Chat

Sign in with: email

Email: username@librem.one

Advanced settings

Homeserver URL: https://chat.librem.one

Librem Social

Server: social.librem.one

Username: username@librem.one

Librem Mail

Username: username@librem.one

Authentification: normal password

	Server	Port	Security
Incoming	imap.librem.one	143	STARTTLS
		993	SSL/TLS
Outgoing	smtp.librem.one	587	STARTTLS
		465	SSL/TLS

Note

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: https://librem.one/public/certificate.ovpn

2 - Log in to your account at: librem.one

3 - While you are log in at: librem.one, open a new tab in your browser and go to: https://librem.one/api/v1/user/tunnel_account

And from there you can retrieve your Tunnel credentials.

Install Librem Tunnel in other GNU/Linux distributions

Note

The Installation instructions for PureOS https://docs.puri.sm/Librem_One/PureOS/VPN_Tunnel.html 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: https://docs.puri.sm/Librem_One/PureOS/VPN_Tunnel.html#install-librem-tunnel-in-pureos

Kubuntu

Install extra dependency: gir1.2-nm-1.0

Then follow the normal instructions at: https://docs.puri.sm/Librem_One/PureOS/VPN_Tunnel.html#install-librem-tunnel-in-pureos

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

https://docs.puri.sm/Librem_One/PureOS/VPN_Tunnel.html#install-librem-tunnel-in-pureos

GalliumOS/Xubuntu

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: https://docs.puri.sm/Librem_One/PureOS/VPN_Tunnel.html#configuring-librem-tunnel

Arch Linux

Install extra dependencies: python-gobject, python-requests Download the ldh_client at: https://source.puri.sm/liberty/ldh_client Edit line 67 of nm_tunnel_setup.py and remove x86_64-linux-gnu/ https://source.puri.sm/liberty/ldh_client/blob/master/scripts/nm_tunnel_setup.py#L67

Run the install script locally.

Then follow the account setup instructions at: https://docs.puri.sm/Librem_One/PureOS/VPN_Tunnel.html#configuring-librem-tunnel

Manjaro Linux

Install extra dependencies: python-gobject, python-requests, gobject-introspection Download the ldh_client at: https://source.puri.sm/liberty/ldh_client Edit line 67 of nm_tunnel_setup.py and remove x86_64-linux-gnu/ https://source.puri.sm/liberty/ldh_client/blob/master/scripts/nm_tunnel_setup.py#L67.

Run the install script locally.

Then follow the account setup instructions at: https://docs.puri.sm/Librem_One/PureOS/VPN_Tunnel.html#configuring-librem-tunnel

—

Fedora

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 nm_tunnel_setup.py 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/libnm-vpn-plugin-openvpn.so”: Needs to install: network-manager-openvpn-gnome network-manager-openvpn

Something went wrong when connecting to https://librem.one/api/v1/user/tunnel_account Problem details: Internal Server Error User tried to setup the account with username@librem.one``**, 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.’ https://bugzilla.redhat.com/show_bug.cgi?id=510779 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)