You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

1.9 KiB

Liberty CLI

project | code | tracker

Liberty CLI is a user-facing command-line client for interacting with a Liberty Deckplan Host (LDH).


The preferred way to install Liberty CLI is with your package manager. The recommended package name is ldh_client. For example:

sudo apt install ldh-client # Debian-based (doesn't exist yet)


pipx install ldh-client


Get help

liberty --help

Add Librem One tunnel VPN to your Network-Manager connections:

liberty tunnel-setup

I will ask your Librem One username and password.

Installation (from source)

If you’d prefer to run from source...

  1. Install Python 3.x and pipenv. (See for a tutorial.)

  2. Get source:

     git clone
  3. Install with pipenv:

     apt-get install libcairo2-dev libgirepository1.0-dev
     cd ldh_client
     pipenv install --dev -e .

Usage (from source)

cd ldh_client
pipenv run liberty --help

Sharing and contributions

Liberty CLI (LDH client)
Copyright 2018-2019 Purism SPC
SPDX-License-Identifier: AGPL-3.0-or-later

Shared under AGPL-3.0-or-later. We adhere to the Community Covenant 1.0 without modification, and certify origin per DCO 1.1 with a signed-off-by line. Contributions under the same terms are welcome.

For details see: