GitHub-Azure-CI-Runner-Agent

GitHub-Azure-CI-Runner-Agent

Docker app from GoldnGroup's Repository

Overview

Self-hosted CI runner for GitHub Actions and Azure Pipelines. Run builds directly on Unraid with optional embedded Docker support. Supports GitHub Actions runners, Azure DevOps Pipelines agents, PowerShell 7, and Docker builds inside the container. Designed for home lab CI/CD, private automation pipelines, and self-hosted build infrastructure. Keywords: GitHub runner, GitHub Actions, Azure Pipelines, Azure DevOps agent, CI/CD, self-hosted runner, Docker builds.

Runtime arguments

Network
bridge
Shell
sh
Privileged
false
Extra Params
--restart unless-stopped

Template configuration

Runner DataPathrw

Persistent storage for runner configuration, work folders, updates, and embedded Docker data. Use a unique appdata path per container. Do not map this to /runner.

Target
/runner-data
Default
/mnt/user/appdata/github-azure-ci-runner-agent
Value
/mnt/user/appdata/github-azure-ci-runner-agent
Use Azure Pipelines AgentVariable

Set to true to enable Azure Pipelines Agent. If false, all Azure DevOps fields are ignored.

Target
USE_AZDO
Default
false
Value
false
Azure DevOps URLVariable

Azure DevOps organization URL. Example: https://dev.azure.com/myorg

Target
AZP_URL
Default
https://dev.azure.com/YOUR_ORG
Value
https://dev.azure.com/YOUR_ORG
Azure DevOps PATVariable

Azure DevOps Personal Access Token with Agent Pools Read and manage permission. Required only when Use Azure Pipelines Agent is true.

Target
AZP_TOKEN
Azure Agent PoolVariable

Azure DevOps Agent Pool name. The pool must already exist in Azure DevOps. Default: SelfHosted.

Target
AZP_POOL
Default
SelfHosted
Value
SelfHosted
Azure Agent NameVariable

Name shown for this agent in Azure DevOps.

Target
AZP_AGENT_NAME
Default
unraid-azure-pipelines-agent
Value
unraid-azure-pipelines-agent
Azure Agent Work FolderVariable

Azure Pipelines work folder. Leave as _work unless you need a custom path.

Target
AZP_WORK
Default
_work
Value
_work
Use GitHub Actions RunnerVariable

Set to true to enable GitHub Actions Runner. If false, all GitHub fields are ignored.

Target
USE_GITHUB
Default
false
Value
false
GitHub ScopeVariable

Use repo for a repository runner, or org for an organization-level runner.

Target
GITHUB_SCOPE
Default
repo
Value
repo
GitHub Repository URLVariable

GitHub repository URL. Required only when GitHub Scope is repo. Example: https://github.com/myorg/myrepo

Target
GITHUB_URL
Default
https://github.com/YOUR_ORG/YOUR_REPO
Value
https://github.com/YOUR_ORG/YOUR_REPO
GitHub OrganizationVariable

GitHub organization name. Required only when GitHub Scope is org. Example: myorg

Target
GITHUB_ORG
Default
YOUR_ORG
Value
YOUR_ORG
GitHub PATVariable

GitHub Personal Access Token used to register the runner. For repo scope, grant Administration Read and Write on the selected repository. Required only when Use GitHub Actions Runner is true.

Target
GITHUB_PAT
GitHub Runner NameVariable

Name shown for this runner in GitHub.

Target
GITHUB_RUNNER_NAME
Default
unraid-github-actions-runner
Value
unraid-github-actions-runner
GitHub Runner LabelsVariable

Comma-separated labels used to target this runner in workflows. Default: SelfHosted. Example: SelfHosted,unraid,docker

Target
GITHUB_RUNNER_LABELS
Default
SelfHosted
Value
SelfHosted
GitHub Runner Work FolderVariable

GitHub Actions work folder. Leave as _work unless you need a custom path.

Target
GITHUB_WORK
Default
_work
Value
_work
Enable Embedded DockerVariable

Set to true to enable Docker builds inside the runner container. Requires Extra Parameters to include --privileged.

Target
ENABLE_DOCKER
Default
false
Value
false
Docker Storage DriverVariable

Storage driver used by embedded Docker. Default vfs is slower but works reliably with Unraid appdata paths such as /mnt/user/appdata. Use overlay2 only if Runner Data is mapped to a path or filesystem that supports overlay mounts, for example a suitable cache or disk path.

Target
DOCKER_STORAGE_DRIVER
Default
vfs
Value
vfs
Advanced Docker OptionsVariable

Optional extra options passed to the embedded Docker daemon. Leave empty unless troubleshooting or customizing Docker.

Target
DOCKER_OPTS

Details

Repository
ghcr.io/goldngroup/github-actions-runner-azure-pipelines-agent:latest
Last Updated2026-05-31
First Seen2026-05-12

Run GitHub-Azure-CI-Runner-Agent on Unraid.

GitHub-Azure-CI-Runner-Agent is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.