Who is this for?

This is an introductory topic for software developers interested in running their CI flows on Windows on Arm machines.

What will you learn?

Upon completion of this Learning Path, you will be able to:

  • Setup a CI/CD flow with GitHub Actions to use Windows on Arm as the self-hosted runner host
  • Run a simple GitHub Actions workflow

Prerequisites

Before starting, you will need the following:

  • Some familiarity with CI/CD concepts is assumed
  • Valid GitHub account
  • Microsoft Azure account (if using virtual machine)

Summary

AI-assisted

This summary was drafted with an approved AI-assisted workflow and reviewed by Arm contributors before publication. Human technical review remains part of the process so the final page reflects engineering rigor, accuracy, and Arm editorial standards.

Close
?
You’ll configure a GitHub Actions CI/CD flow on a Windows on Arm host. First, you’ll create a repository, set up a self-hosted runner on a device or cloud instance, and add a minimal workflow from the Simple workflow template. Then, you’ll run a hello world task to verify that jobs execute on your Windows on Arm runner.

Frequently asked questions

AI-assisted

These FAQs were drafted with an approved AI-assisted workflow and reviewed by Arm contributors before publication. Human technical review remains part of the process so the final page reflects engineering rigor, accuracy, and Arm editorial standards.

Close
?
Why should I create a new GitHub repository for this exercise?
A new repository provides a clean space to test a hello world command with GitHub Actions without impacting existing code or workflows.
Which option should I choose in the repository to start the minimal workflow?
Select Actions in the repository and start with the Simple workflow, then select Configure to generate the starter file.
Where does GitHub create the workflow file, and can I rename it?
GitHub creates blank.yml under <your-repo-name>/.github/workflows/. You can optionally rename it to something more meaningful, such as hello.yml.
What result should I expect when the workflow runs successfully?
The run completes with the minimal steps executing, including the hello world command, and the job status shows success. This confirms the CI/CD workflow is operational on the Windows on Arm host.
Can I use a virtual machine instead of a physical Windows on Arm device?
Yes. You can host the runner on a Windows on Arm virtual machine or cloud instance.
Next