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

Self-hosted runners

For aarch64 images, we have self-hosted VMs, provided by Oracle OCI.

To setup a new runner:

1. Create an Oracle VM.Standard.A1.Flex with 1 OCPU and 6 GB using Ubuntu 22.04 image.

2. Run under root:

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

   This will perform initial runner setup and create a non-root user runner-user.

3. Setup new GitHub Runner with this user: https://github.com/jupyter/docker-stacks/settings/actions/runners/new using Linux and ARM64.

4. Run under root user in Runner directory: ./svc.sh install runner-user