apko YAML Reference
This page provides a reference for apko’s YAML specification.
This section defines sources and packages you want to include in your image.
|repositories||A list of apk repositories for this image. Supports either Alpine or Wolfi apk repositories.|
|packages||A list containing all packages that should be installed as part of a given image’s requirements.|
*It is not recommended to mix Alpine apks with Wolfi apks.
contents: repositories: - https://dl-cdn.alpinelinux.org/alpine/edge/main packages: - alpine-base
This section defines an entry point command for your image.
|command||The command that should be executed as entry point for this image.|
entrypoint: command: /usr/bin/php81
The architectures to build. This top-level directive expects a list with all architectures that should be a target for the build. By default, apko will try to build for all architectures that are currently supported.
archs: - x86_64
This section defines environment variables that will be set for this image.
environment: PATH: /usr/sbin:/sbin:/usr/bin:/bin myVAR: "test"
This section defines users and groups that should be added to this image.
|groups||A list with the groups that should be present in this image.|
|users||A list with the user accounts that should be present in this image.|
|run-as||The default user to run the entrypoint command.|
accounts: groups: - groupname: nonroot gid: 65532 users: - username: nonroot uid: 65532 run-as: root