Deploy GitHub Actions workflows using Windows Sandbox
Introduction
Configure Windows Sandbox as your GitHub Actions self-hosted Arm64 runner
Build and run the .NET application using the GitHub Actions workflow
Next Steps
Deploy GitHub Actions workflows using Windows Sandbox
Who is this for?
This is an introductory topic for software developers who are developing applications on Windows on Arm computers.
What will you learn?
Upon completion of this Learning Path, you will be able to:
- Configure Windows Sandbox as a self-hosted GitHub Actions runner.
- Build and run a .NET 8 Windows Presentation Foundation (WPF) application using a self-hosted GitHub Actions runner in your CI/CD workflow.
Prerequisites
Before starting, you will need the following:
- A Windows on Arm computer such as the Lenovo Thinkpad X13s running Windows 11 Version 22H2 which has Windows Sandbox enabled .
- A valid GitHub account to complete this Learning Path.
Summary
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.
You’ll configure Windows Sandbox on a Windows on Arm device as a self-hosted Arm64 GitHub Actions runner. First, you’ll prepare the sandbox, register the runner, and use a repository workflow to build and publish a .NET 8 WPF sample. Then, you’ll trigger the pipeline and verify that jobs run in the sandboxed environment and produce the expected outputs.
Frequently asked questions
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.
The workflow is defined at
.github/workflows/dotnet_sandbox.yml. It triggers on pushes to the main branch and can also be started manually from the Actions tab.Open the workflow run details and check the job’s runner information. It should indicate that a self-hosted runner executed the job from your sandboxed environment.
The workflow run shows a success status, and the logs for the build and run steps complete without errors. If the workflow includes a publish step, you’ll also see published outputs listed in the run summary.
Confirm you pushed to the main branch and that
.github/workflows/dotnet_sandbox.yml exists in the repository. If needed, start the workflow manually from the Actions tab.Verify that Windows Sandbox is enabled on your Windows 11 device as described in the
Windows Sandbox install guide
. This ensures the sandbox environment is available to register as a runner.