Skip to content

Enable build configuration

Igor edited this page Aug 19, 2023 · 8 revisions

Armbian build system includes many build configurations, but we are producing only some possible build options for all images. Only the most popular ones get everything, while others get the bare minimum, some nothing.

To enable a board that exists in build configurations, edit yaml files here:

└── userpatches
    ├── targets-release-nightly.yaml        # nightly automated builds
    └── targets-release.yaml                # stable images

and send a pull request. After PR is merged, CI executes nightly images rebuild. If board is already present at main Armbian download pages https://www.armbian.com/download then images will be available there after CI finishes. If not, locate your image here https://github.com/armbian/os/releases/latest.

Example:

common-gha-configs:
  armbian-gha: &armbian-gha
    runners:
      default: "ubuntu-latest"
      by-name:
        kernel: [ "self-hosted", "Linux", "alfa" ]
        uboot:  [ "self-hosted", "Linux", "fast", "X64" ]
        armbian-bsp-cli: [ "fast" ]

targets:
  all-desktop:
    enabled: yes
    configs: [ armbian-images ]
    pipeline:
      gha: *armbian-gha
    vars:
      BUILD_MINIMAL: "no"
      BUILD_DESKTOP: "yes"
      DESKTOP_ENVIRONMENT: "xfce"
      DESKTOP_ENVIRONMENT_CONFIG_NAME: "config_base"
      DESKTOP_APPGROUPS_SELECTED: "none"
      RELEASE: "jammy"
    items-from-inventory:
      #wip: yes # includes all work-in-progress boards
      #all: yes # includes all available BOARD and BRANCH combinations
      #conf: yes # includes all supported boards
      #not-eos: yes # not-eos boards, all branches
      not-eos-with-video: yes # not-eos boards, all branches, with video out

The configuration file should be self-explanatory.

Clone this wiki locally