docker-stacks/docs/maintaining/aarch64-runner.md

Self-hosted runners

For building aarch64 images, we use self-hosted GitHub runners. It is recommended to have at least two runners to allow better parallelism. Each runner is recommended to have at least 2 cores and 30 GB of disk space.

Add a new runner:

• To use Oracle OCI, create a compute instance VM.Standard.A1.Flex.
• To use Google Cloud, use this instruction.

Configure your runner:

1. Run under root:

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/jupyter/docker-stacks/HEAD/aarch64-runner/setup.sh)"
   

   This will perform the initial runner setup and create a user runner-user without sudo capabilities.

2. Set up a new GitHub Runner under runner-user using GitHub Instructions. Do not ./run.sh yet.

3. Run under root:

   cd /home/runner-user/actions-runner/ && ./svc.sh install runner-user
   

4. Reboot the VM to apply all updates and run GitHub runner.