Built something? We create video reels & spotlights for GitHub projects.Promote your project →
actions
Home / Go / actions-runner-controller

actions/actions-runner-controller

Kubernetes controller for GitHub Actions self-hosted runners

Go ◇ github-actions Apache-2.0
★6.5KSTARS
⑂1.5KFORKS
!397ISSUES
🏆#1,351GLOBAL RANK
🔥2DAYS TRENDING
🚀
Maintainer Growth Kit for actions-runner-controller

Claim this project, add your verified backlink badge to your README, and download milestone cards.

Claim Repo

Star History

Continuous Observations
Interactive star growth chart for actions/actions-runner-controller
CSV
⭐ VIRAL README KIT

Add Live Star History & Verified Badges to README.md

Keep your repository README looking professional and dynamic. As our continuous crawler records new stars, these official SVG badges update in real time with zero maintenance.

Open README on GitHub ↗
Option 1: Interactive Star History Chart Dynamic SVG

Renders your high-resolution star trajectory chart right inside your GitHub README or project docs.

actions/actions-runner-controller Star History Preview
markdown
[![Star History Chart](https://githubrepo.cloud/api/badge/chart/actions/actions-runner-controller.svg?theme=dark)](https://githubrepo.cloud/repo/actions/actions-runner-controller?utm_source=readme_chart)
Direct SVG Link ↗
Option 2: Verified Shields Badges Shields.io Style

Compact Shields-style badges for your README header. Shows real-time stars and global ranking.

Featured badge Stars badge Rank badge
markdown (badge trio)
[![Featured on GitHubRepo.cloud](https://githubrepo.cloud/badge/actions/actions-runner-controller.svg?metric=featured)](https://githubrepo.cloud/repo/actions/actions-runner-controller?utm_source=readme_badge) [![GitHubRepo Stars](https://githubrepo.cloud/badge/actions/actions-runner-controller.svg?metric=stars)](https://githubrepo.cloud/repo/actions/actions-runner-controller?utm_source=readme_badge) [![Global Rank](https://githubrepo.cloud/badge/actions/actions-runner-controller.svg?metric=rank)](https://githubrepo.cloud/repo/actions/actions-runner-controller?utm_source=readme_badge)

Momentum

+164

STARS · LAST 30 DAYS

5

PER DAY

#190

MOST-STARRED Go

Window7 days30 days90 days
Stars gained+35+164+450
Per day555
Forks gained+7+30+74

actions-runner-controller gained 164 stars in the last 30 days, about 5 a day, and now has 6.5K. It is about 7 years old and has averaged roughly 935 stars a year. It ranks #190 among Go repositories and #1,351 across all languages on GitHubRepo.

Trending Record

actions-runner-controller has maintained a continuous presence across global trending indexes, peaking at #2960. Below is the 30-day activity profile:

💡 Overview

actions-runner-controller is an open-source project written in Go: Kubernetes controller for GitHub Actions self-hosted runners.

Engineered for speed, consistency, and developer ease, it solves common hurdles in github-actions, kubernetes, operator. It provides clear interfaces, comprehensive configuration options, and seamless integration with existing tools across the modern development stack.

⚡ Key Features

1

Optimized execution pipeline written in Go for predictable speed.

2

Zero-friction configuration with comprehensive sensible defaults out of the box.

3

Cross-platform runtime support across Linux, macOS, and Windows environments.

4

Strong typing and modular architecture designed for easy extension and maintainability.

5

Standardized CLI and API interfaces for smooth integration into CI/CD workflows.

6

Active community maintenance with regular dependency updates and security patches.

📥 Installation

terminal
$ go install github.com/actions/actions-runner-controller@latest

⚙ System Requirements

Platforms

  • • macOS
  • • Linux
  • • Windows

Runtime & Dependencies

Go >= 1.21 runtime environment

Architecture

x86_64, ARM64 (Apple Silicon & Graviton)

🧠 How It Works

actions-runner-controller coordinates its core functionality through a modular Go pipeline. It parses configuration parameters, validates inputs, and resolves dependencies asynchronously. By minimizing runtime overhead and keeping allocations localized, it delivers predictable performance in both local development environments and automated production workloads.

🎯 Production Use Cases

Production System Integration

Embed actions-runner-controller into Go backend services to handle core application logic.

CI/CD Automated Pipelines

Run automated validation, builds, and integration suites during deployments.

Developer Tooling & Workflows

Accelerate developer onboarding with pre-configured project utilities.

Open Source Extension

Fork and customize internal modules under the repository's open Apache-2.0 license.

🚀 Getting Started

1

Install actions-runner-controller using your package manager: `go install github.com/actions/actions-runner-controller@latest`

2

Initialize your project workspace or configuration file for actions-runner-controller.

3

Import actions-runner-controller into your codebase or invoke it directly from your terminal.

4

Execute your test suite or run `actions-runner-controller --help` to verify successful setup.

👍 Strengths

Active community backing with 6,542 GitHub stars and verified adoption.
Permissive open-source distribution under the Apache-2.0 license.
Built in Go for high execution speed and developer familiarity.
Cross-platform compatibility across modern Linux, macOS, and Windows environments.
Clean modular design allowing flexible configuration and pipeline integration.

⚠️ Considerations

Requires familiarity with Go and modern CLI workflows.
Ecosystem extensions may require manual configuration depending on environment constraints.
Active development roadmap means breaking API changes may occur across major versions.

⇄ Alternatives & Direct Competitors

A
avelino/awesome-go ★ 186.4K Go

A curated list of awesome Go frameworks, libraries and software

Compare ↗
O
ollama/ollama ★ 182K Go

Get up and running with Kimi, GLM, MiniMax, DeepSeek, gpt-oss, Qwen, Gemma and other models.

Compare ↗
G
golang/go ★ 139.1K Go

The Go programming language

Compare ↗
K
kubernetes/kubernetes ★ 128.2K Go

Production-Grade Container Scheduling and Management

Compare ↗

👥 Who Should Use This

Developers and engineering teams building with Go, seeking reliable, tested, and actively maintained tooling for production workloads.

🏆 Nearby in the Rankings

actions/actions-runner-controller is currently ranked #1,351 by stars across every repository tracked on GitHubRepo. These are adjacent projects:

RankRepositoryLanguageStarsAction
#1,346 sebastianbergmann/recursion-context PHP ★ 6.6K Compare ↗
#1,347 spotiflacapp/SpotiFLAC-Mobile Dart ★ 6.6K Compare ↗
#1,348 MISP/MISP PHP ★ 6.6K Compare ↗
#1,349 google-ai-edge/LiteRT-LM C++ ★ 6.6K Compare ↗
#1,350 anus-dev/ANUS JavaScript ★ 6.5K Compare ↗
#1,351 actions/actions-runner-controller This Project Go ★ 6.5K
#1,352 photoview/photoview Go ★ 6.5K Compare ↗
#1,353 lldap/lldap Rust ★ 6.5K Compare ↗
#1,354 cloudquery/cloudquery Go ★ 6.5K Compare ↗
#1,355 larastan/larastan PHP ★ 6.5K Compare ↗
#1,356 sebastianbergmann/object-enumerator PHP ★ 6.5K Compare ↗

Frequently Asked Questions

What does actions-runner-controller do? +

Kubernetes controller for GitHub Actions self-hosted runners

What language is actions-runner-controller written in? +

The primary language is Go. Topics include: github-actions, kubernetes, operator.

Is actions-runner-controller actively maintained? +

Yes, the last recorded push was on Oct 2, 2026 with 397 open issues being tracked.

How many stars does actions-runner-controller have? +

actions-runner-controller has 6,542 stars and 1,488 forks on GitHub.

How does actions-runner-controller rank among GitHub repositories? +

With 6,542 stars, actions/actions-runner-controller is ranked #1,351 globally across all repositories tracked on GitHubRepo and #190 among Go projects.

What license is actions-runner-controller distributed under? +

The repository reports a Apache-2.0 license. Always verify the repository LICENSE file for legal terms.

From our network
FOR MAINTAINERS

Built something? Put it in front of millions of developers.

We make a short reel about your project and post it across YouTube, Instagram, Threads, and X. Send a link, we do the rest.