Librem 5 System Images

The Continuous Integration (CI) system builds several images categorized by “os”, “board” and “kernel freshness” available from the Image Builds page.

When searching for images to use, please ensure that you choose the correct one for the hardware you are using.

Operating System (OS)

This describes the GNU/Linux distribution used for the image, and especially the user space components:

  • buster+ci: Debian Buster plus packages of our software that is built on commit. This contains the most recent changes and can break at any time.
  • amber-phone-staging: PureOS amber plus packages of releases of our software. This is mostly useful for testing newly built packages before they become available in the amber-phone distribution.
  • amber-phone: PureOS amber plus packages of our software that waited 3 days in amber-phone-staging and that have all dependencies fulfilled in amber-phone. This is expected to contain more mature, robust software.

Bugs in amber-phone and in amber-phone-staging should be marked as found in the respective releases:

Board

Images are built for three different hardware platforms:

  • devkit: the Librem 5 development kit
  • librem5: the Librem 5 phone
  • qemu-x86_64: an amd64 image running in QEmu

Users of qemu on workstation hardware (typically amd64) should use qemu-x86_64 images.

Kernel Freshness

This indicates the stability of the kernel used in the image:

  • next: experimental kernel
  • current: the kernel that should currently be used
  • legacy: an old kernel, kept around to diagnose regressions
  • plain: the plain kernel from the Debian/PureOS archive

Generally, users looking for a stable experience should use images with current kernels. Those looking to fix problems with the kernel itself will probably use images with next kernels.