Installation

Binary Releases

Our official LibrePCB binary releases contain the librepcb-cli executable next to the GUI application, so usually no separate installation is needed. But there are two exceptions: The AppImage and the macOS bundle.

Linux AppImage

Download librepcb-cli-1.1.0-linux-x86_64.AppImage, make it executable and run it:

wget "https://download.librepcb.org/releases/1.1.0/librepcb-cli-1.1.0-linux-x86_64.AppImage"
chmod +x ./librepcb-cli-1.1.0-linux-x86_64.AppImage
./librepcb-cli-1.1.0-linux-x86_64.AppImage

macOS Bundle

Download the portable *.dmg file matching your CPU architecture:

Intel (x86_64): librepcb-cli-1.1.0-mac-x86_64.dmg
Apple Silicon (arm64): librepcb-cli-1.1.0-mac-arm64.dmg

Double-click the downloaded file in Finder. Then drag and drop the app onto the "Applications" folder in Finder.

Docker Image

The easiest way to get the LibrePCB CLI on Linux (especially for usage on CI) is to pull our official Docker image librepcb/librepcb-cli:

docker run -it --rm -v `pwd`:/work -u `id -u`:`id -g` \
    librepcb/librepcb-cli:1.1.0 --help