Linux

  • Minimum Requirements

    • Quad-core CPU running at 2.0 GHz+

    • 8 GiB of RAM

  • Recommended Requirements

    • 6th Gen Intel® Core CPU or later OR AMD Ryzen™ 1000-series or later

    • 16 GiB of RAM

For Ubuntu, only 22.04 and above are officially supported.

Installation of required packages

Update the package database and upgrade the packages to avoid version mismatches then install required packages as follows:

sudo apt-get update
sudo apt-get install -y build-essential python3 python3-venv python3-pip python3-tk curl make git

Downloading the LibreLane AppImage

Download the latest release from https://github.com/librelane/librelane/releases/latest using your browser.

Most people should download librelane-devshell-x86_64.AppImage, but those on ARM-based computers should download librelane-devshell-aarch64.AppImage.

In a terminal, do the following:

  1. Move the downloaded AppImage to your home directory, e.g.:

    $ mv ~/Downloads/librelane-devshell-$(uname -m).AppImage ~

  2. Give execution permissions for the LibreLane AppImage:

    $ chmod a+x ~/librelane-devshell-$(uname -m).AppImage

Entering the LibreLane Environment

From your terminal, simply type ~/librelane-devshell-$(uname -m).AppImage.

Your prompt should now look kind of like this:

[nix-shell:~]$

That’s it! You are now inside the LibreLane environment and can run any of the included tools.

You can test that LibreLane works correctly by running librelane --smoke-test.