# Implement CI/CD with Windows on Arm host

## In this learning path

- [Introduction](https://learn.arm.com/learning-paths/laptops-and-desktops/windows_cicd_github/)
- [Setup GitHub Self-hosted Runner](https://learn.arm.com/learning-paths/laptops-and-desktops/windows_cicd_github/runner-setup/)
- [Create and run simple workflow](https://learn.arm.com/learning-paths/laptops-and-desktops/windows_cicd_github/runner-run/)
- [Next Steps](https://learn.arm.com/learning-paths/laptops-and-desktops/windows_cicd_github/_next-steps/)

## About this Learning Path

|  |  |
| --- | --- |
| Skill level: | Introductory |
| Reading time: | 30 min |
| Last updated: | 12 Aug 2026 |

|  |  |
| --- | --- |
| Author: | Pareena Verma , Arm<br>[GitHub](https://github.com/pareenaverma)<br>[LinkedIn](https://linkedin.com/in/pareena-verma-7853607) |
| Arm IP: | [Neoverse](https://support.arm.com/?tab=compute-ip&Product%20Type=Infrastructure%20Processors) |
| Tags: | [CI-CD](https://learn.arm.com/tag/ci-cd) [Windows](https://learn.arm.com/tag/windows) [GitHub](https://learn.arm.com/tag/github) |

### 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?
After completing this Learning Path, you'll be able to perform the following tasks:
- 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'll need the following prerequisites:
- Some familiarity with CI/CD concepts is assumed
- Valid GitHub account
- Microsoft Azure account (if using virtual machine)

### Summary
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
**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.