# GitHub-Azure-CI-Runner-Agent

GitHub-Azure-CI-Runner-Agent is a self-hosted development app. Self-hosted CI runner that executes GitHub Actions and Azure Pipelines builds directly on Unraid, with optional embedded Docker support for containerised job execution. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/2850/github-azure-ci-runner-agent

## Description

Self-hosted CI runner that executes GitHub Actions and Azure Pipelines builds directly on Unraid, with optional embedded Docker support for containerised job execution.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

40/100 (Fair), based on 3 of 4 factors.
- Maintained: 64 (last commit 111 days ago)
- Popular: 6 (1 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/github-azure-ci-runner-agent-07gjlst05x79g9?q=GitHub-Azure-CI-Runner-Agent

## Common questions

### What GitHub and Azure token permissions are required?

A GitHub repository runner needs a PAT with Repository Administration read and write. An organization runner needs Organization self-hosted runners read and write, and an Azure Pipelines agent needs Agent Pools read and manage.

### Where does the container store persistent configuration and runner data?

All runtime data is stored under /mnt/user/appdata/github-actions-runner-azure-pipelines-agent. The configuration persists across restarts, so the runner does not need to be re-registered.

### How do I enable Docker builds inside the runner?

Set ENABLE_DOCKER to true and add --restart unless-stopped and --privileged to the container parameters. This starts a Docker daemon inside the container, so the container runs in privileged mode.

### How can I run both GitHub Actions and Azure Pipelines in the same container?

Set USE_GITHUB and USE_AZDO to true. You also need to provide the matching GitHub and Azure credentials, such as GITHUB_PAT, GITHUB_URL or GITHUB_ORG, and AZP_URL with AZP_TOKEN.

### How do I update the runner image?

Pull the latest image and restart the container. The container downloads or reuses the latest runner binaries on startup.

---
Source: Our Local Host (https://ourlocalhost.com/app/2850/github-azure-ci-runner-agent), the self-hosted and open-source app directory.
