Specifying The Runner Image

By default, the default image of the server for the runner is ubuntu-22.04. You can use the --default-image option to force a specific default server image.

You can also use the image-{architecture}-{type}-{name} runner label to specify the server image for a specific job.

Where,

• {architecture} is either x86 or arm ✅ Available: >= 1.9, you can also use arm64 and aarch64 aliases.
• {type} is either system, snapshot, backup, or app
• {name} must be a valid Hetzner Cloud image name, for system or app type, such as ubuntu-22.04, or a description, for backup or snapshot type.

For example, for x86:

ubuntu-20.04:	job-name: runs-on: [self-hosted, type-cx22, in-fsn1, image-x86-system-ubuntu-20.04]
docker-ce app:	job-name: runs-on: [self-hosted, type-cx22, in-fsn1, image-x86-app-docker-ce]
snapshot:	For snapshots, specify description as the name. Snapshot descriptions must be unique. job-name: runs-on: [self-hosted, type-cx22, in-fsn1, image-x86-snapshot-snapshot_description]

For example, for arm:

ubuntu-20.04:	job-name: runs-on: [self-hosted, type-cx22, in-fsn1, image-arm-system-ubuntu-20.04] ✅ Available: >= 1.9, you can also use arm64 or aarch64 aliases: job-name: runs-on: [self-hosted, type-cx22, in-fsn1, image-arm64-system-ubuntu-20.04] job-name: runs-on: [self-hosted, type-cx22, in-fsn1, image-aarch64-system-ubuntu-20.04]
docker-ce app:	job-name: runs-on: [self-hosted, type-cx22, in-fsn1, image-arm-app-docker-ce] ✅ Available: >= 1.9, you can also use arm64 or aarch64 aliases: job-name: runs-on: [self-hosted, type-cx22, in-fsn1, image-arm64-app-docker-ce] job-name: runs-on: [self-hosted, type-cx22, in-fsn1, image-aarch64-app-docker-ce]
snapshot:	For snapshots, specify description as the name. Snapshot descriptions must be unique. job-name: runs-on: [self-hosted, type-cx22, in-fsn1, image-arm-snapshot-snapshot_description] ✅ Available: >= 1.9, you can also use arm64 or aarch64 aliases: job-name: runs-on: [self-hosted, type-cx22, in-fsn1, image-arm64-snapshot-snapshot_description] job-name: runs-on: [self-hosted, type-cx22, in-fsn1, image-aarch64-snapshot-snapshot_description]