Producing AppImages on Gitlab CI

appimage-builder can be easily integrated into a gitlab-ci recipe. Here you will learn how to do it.

Docker Images

There is an appimage-builder docker image ready to be used on gitlab-ci you can find it here. It’s based on Ubuntu 18.04 and brings all the dependencies required by the tool. The docker image name is: appimagecrafters/appimage-builder.


The usual approach while writing a gitlab-ci recipe for building AppImages is to use the before_script section to install the application dependencies. In the script section we will do the project configuration, binary building and the AppImage generation.

In the code snippet below you can find a complete gitlab-ci.yml recipe for building an AppImage for a Hello World Qt project using the latest Qt from the KDE Neon repositories

    image: appimagecrafters/appimage-builder
      # update appimage-builder (optional)
      - apt-get update
      - apt-get install -y git wget
      - pip3 install --upgrade git+

      # app build requirements
      - echo 'deb bionic main' > /etc/apt/sources.list.d/neon.list
      - wget -qO - | apt-key add -
      - apt-get update
      - apt-get install -y qt5-default qtdeclarative5-dev cmake
      - cmake . -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr
      - make install DESTDIR=AppDir
      - appimage-builder --skip-test
        - '*.AppImage*'
      expire_in: 1 week


Any Gitlab instance can be used to host your AppImage builds but it’s recommended to do it on This instance part of the OpenDesktop ecosystem were the AppImageHub project lives. This will allow to mark published binaries as “OFFICIAL”.