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 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)