LibrePCB CI/Development Docker Images
This repository contains the Dockerfiles to build the images used for
continuous integration of LibrePCB.
The built images are hosted at
Docker Hub.
Available Tags
ubuntu-22.04-qt6.10
Based on Ubuntu 22.04, containing Qt 6.10.x from
download.qt.io and OpenCascade OCCT from
github/Open-Cascade-SAS/OCCT.
This image is intended for deployment of official binary releases of LibrePCB,
which should be linked against an old version of glibc (for maximum
compatibility) but still using a recent Qt version (to get the latest
features/bugfixes of Qt).
In addition, this image contains
linuxdeployqt to build the
AppImage.
ubuntu-22.04-qt6.11
Based on Ubuntu 22.04, containing Qt 6.11.x from
download.qt.io and OpenCascade OCCT from
github/Open-Cascade-SAS/OCCT.
This image is intended for deployment of official binary releases of LibrePCB,
which should be linked against an old version of glibc (for maximum
compatibility) but still using a recent Qt version (to get the latest
features/bugfixes of Qt).
In addition, this image contains
linuxdeployqt to build the
AppImage.
ubuntu-22.04
Based on Ubuntu 22.04, containing Qt from the official Ubuntu package
repository. This image is intended to check if LibrePCB compiles on a standard
Ubuntu 22.04.
In addition, this image contains necessary tools for dynamic linking of
LibrePCB (pkg-config, libdxflib, libmuparser, libquazip, libpolyclipping,
googletest).
ubuntu-24.04
Based on Ubuntu 24.04, containing Qt from the official Ubuntu package
repository. This image is intended to check if LibrePCB compiles on a standard
Ubuntu.
In addition, this image contains necessary tools for dynamic linking of
LibrePCB (pkg-config, libdxflib, libmuparser, libquazip, libpolyclipping,
googletest).
ubuntu-26.04
Based on Ubuntu 26.04, containing Qt from the official Ubuntu package
repository. This image is intended to check if LibrePCB compiles on a standard
Ubuntu.
In addition, this image contains necessary tools for dynamic linking of
LibrePCB (pkg-config, libdxflib, libmuparser, libquazip, libpolyclipping,
googletest).
Also clang-tidy, clang-tidy-cache and Clazy for the static code analysis
are installed in this image.
windowsservercore-ltsc2025-qt6.10-64bit
Based on Windows Server Core LTSC2025 with Qt6.10.x, MinGW 13.1.0 64-bit
and OpenCascade OCCT 7.9.1. This image is intended for deployment of official
64-bit binary releases of LibrePCB for Windows.
webtools
An image providing all the web tools we need for
librepcb-doc and
librepcb-website:
devtools
An image used by the dev/format_code.sh script in the LibrePCB repository,
providing various tools to format code. In addition, it is used on CI to
check the coding style. Generally you never need to use this image directly.
Updating Images
Important: On Linux, use the helper script ./build.sh since it makes the
procedure less error prone!
- Add/modify the Dockerfiles, update this README and commit all changes.
- Run
./build.sh <image-name> <version> --push to build and push the image.
Use the next unused version number, i.e. the previous image version plus one.
Use just a single number as version identifier, e.g. 1, 2, 3. Semantic
versioning is not needed since CI always links to one specific version.
- Test the new image by pushing the LibrePCB repository to trigger the CI.
- If everything was successful, merge the changes into
master.
- On the
master branch (merge commit checked out!), create the corresponding
Git tag by running ./build.sh <image-name> <version> --tag (can also be
combined with --push to push the image again).
Using Images Locally
To compile LibrePCB locally using these images, run the container like this:
docker run -it --rm \
--user "$(id -u):$(id -g)" \
-v "$(pwd):/code" -w "/code" \
-e OS=linux -e ARCH=x86_64 \
librepcb/librepcb-dev:<tag>
Set up Windows Machine
To build the Docker images for Windows, you need a Windows Server edition of
the same version as our Docker images. Then install Docker CE with this command:
Invoke-WebRequest -UseBasicParsing "https://raw.githubusercontent.com/microsoft/Windows-Containers/Main/helpful_tools/Install-DockerCE/install-docker-ce.ps1" -o install-docker-ce.ps1
.\install-docker-ce.ps1
Source: https://learn.microsoft.com/en-us/virtualization/windowscontainers/quick-start/set-up-environment?tabs=dockerce
License
The content in this repository is published under the
GNU GPLv3 license.