Specifying The Runner Type

x64 Runners

The default server type is cx22, which is an Intel, 2 vCPU, 2GB RAM shared-cpu x64 instance.

✋ Note:	You can use the --default-type option to set a different default server type.

You can specify different x64 server instance type by using the type-{name} runner label. The {name} must be a valid Hetzner Cloud server type name such as cx22, cpx21 etc.

For example, to use an AMD, 3 vCPU, 4GB RAM shared-cpu x64 instance, you can define the runs-on as follows:

job-name:
   runs-on: [self-hosted, type-cpx21]

ARM64 Runners

The default server type is cx22, which is an Intel, 2 vCPU, 2GB RAM shared-cpu x64 instance. Therefore, in order to use ARM64 runners, you must specify the ARM64 server instance type by using the type-{name} runner label. The {name} must be a valid ARM64 Hetzner Cloud server type name such as cax11, cax21 etc. which correspond to the Ampere Altra, 2 vCPU, 4GB RAM and 4 vCPU, 8GB RAM shared-cpu ARM64 instances, respectively. You must also specify a valid ARM image using the image-arm-{type}-{name} runner label.

For example, to use the Ampere Altra, 4 vCPU, 8GB RAM shared-cpu ARM64 instance, running the ubuntu-22.04 image, you must define the runs-on as follows:

job-name:
   runs-on: [self-hosted, type-cax21, image-arm-system-ubuntu-22.04]