Mappings#

mappings describes an architecture mapping between the architectures from those used in Incus and those used by the distribution. These mappings are useful if you for example want to build a x86_64 image but the source tarball contains amd64 as its architecture.

mappings:
    architectures: <map>
    architecture_map: <string>

It’s possible to specify a custom map using the architectures field. Here’s an example of a custom mapping:

mappings:
    architectures:
        i686: i386
        x86_64: amd64
        armv7l: armhf
        aarch64: arm64
        ppc: powerpc
        ppc64: powerpc64
        ppc64le: ppc64el

The mapped architecture can be accessed via Image.ArchitectureMapped in the code or image.architecture_mapped in the definition file.

There are some preset mappings which can be used in the architecture_map field. Those are:

  • alpinelinux

  • altlinux

  • archlinux

  • centos

  • debian

  • funtoo

  • gentoo

  • plamolinux

  • voidlinux