terraform-aws-github-runner

Terraform module for scalable GitHub action runners on AWS

⭐ 3,040 stars on GitHub · 🍴 722 forks · 📜 License: mit · 💻 Language: TypeScript

What is terraform-aws-github-runner?

A standout opensource self-host project on GitHub — host on your own server for full control over your data and costs.

Main components

• Scaling: Scale up and down based on GitHub events
• Sustainability: Scale down to zero when no jobs are running
• Security: Runners are created on-demand and terminated after use (ephemeral runners)
• Cost optimization: Runners are created on spot instances
• Tailored software, hardware and network configuration: Bring your own AMI, define the instance types and subnets to use.
• OS support: Linux (x64/arm64) and Windows
• Multi-Runner: Create multiple runner configurations with a single deployment
• GitHub cloud, GitHub Cloud with Data Residency and GitHub Enterprise Server (GHES) support.

The biggest strength is active opensource community — fast bug fixes, regular features, no abandonment risk.

Best for self-host enthusiasts wanting to try a strong-community opensource project.

Topics: the project is tagged with popular topics:

• 🏷️ action-runner
• 🏷️ actions-runner
• 🏷️ aws
• 🏷️ cicd
• 🏷️ github
• 🏷️ github-actions
• 🏷️ hacktoberfest
• 🏷️ lambda
• 🏷️ scalable
• 🏷️ self-hosted

📸 Screenshots

Quick install

See the README for detailed install instructions. Most projects support Docker — if the repo has a Dockerfile, use:

git clone https://github.com/github-aws-runners/terraform-aws-github-runner.git
cd terraform-aws-github-runner
docker build -t terraform-aws-github-runner .
docker run -d -p 8080:8080 terraform-aws-github-runner

Minimum system requirements

⚡ Deploy fast on VSIS

Use the VSIS VPS Mini 1GB RAM / 1 vCPU / 15GB SSD (~70k/tháng) plan from VSIS.NET — high-speed VN-based VPS, 24/7 support, ideal for running terraform-aws-github-runner smoothly.

🎯 Benefits:

• One-command docker compose up -d deploy in 2 minutes
• Dedicated IPv4, root access, unmetered domestic bandwidth
• Daily snapshot backup
• Free install assistance from the VSIS team

👉 See matching VPS plans at vsis.net

Resources

• 🔗 GitHub: github-aws-runners/terraform-aws-github-runner
• 🌐 Homepage: https://github-aws-runners.github.io/terraform-aws-github-runner/
• 📚 Official docs: see README in the repo
• 💬 Community: GitHub Issues + Discussions

Article compiled from GitHub data on 05/05/2026. Star/fork counts may have changed — see live numbers via the GitHub link.