Home

GitHub Actions Self-Hosted Runner Wiki

Welcome to the comprehensive documentation for the GitHub Actions Self-Hosted Runner project!

🎯 Latest Updates

✅ Chrome Runner Production Ready (Sep 4, 2025)

• Status: ✅ Production Ready - All 10/10 CI/CD checks passing
• Performance: 60% faster web UI tests with resource isolation
• CI/CD: All checks completed successfully (Build, Security, Tests)
• Deployment: Ready for production use with scaling support
• ChromeDriver: Issue resolved with Chrome for Testing API
• Documentation: Chrome Runner Guide

📖 Table of Contents

Getting Started

• Home - Overview and quick start
• Installation Guide - Step-by-step installation
• Quick Start - Get up and running in 5 minutes

Specialized Runners

• Chrome Runner 🆕 - Web UI testing and browser automation
• Docker Configuration - General Docker setup

Configuration

• Production Deployment - Production-ready deployment
• Common Issues - Troubleshooting and solutions

🚀 Quick Start Options

🌐 For Web UI Testing

# Chrome Runner (Recommended for browser tests)
./scripts/build-chrome.sh --push
docker-compose -f docker/docker-compose.chrome.yml up -d

🐳 For General Workloads

# Standard Runner
docker build -t github-runner:latest ./docker
docker-compose up -d

🔗 Quick Links

Component	Status	Documentation
Chrome Runner	✅ Production Ready	Chrome Runner Guide
Standard Runner	✅ Stable	Installation Guide
CI/CD Pipeline	✅ Passing	Production Deployment
Security Scanning	✅ Clean	Common Issues

• Contributing - How to contribute to the project
• Development Workflow - Development processes and standards
• Testing Strategy - Testing approaches and frameworks
• Release Process - Version management and releases

🚀 Quick Links

• Installation Guide - Start here for first-time setup
• Docker Configuration - Essential Docker setup
• Production Deployment - Production checklist
• Common Issues - Troubleshooting help

🔗 External Resources

• GitHub Actions Documentation
• Self-Hosted Runners Guide
• Docker Documentation
• Docker Compose Reference

📝 Contributing to Documentation

Found something missing or incorrect? We welcome contributions to improve this documentation:

1. Visit the main repository
2. Open an issue or submit a pull request
3. Help us keep the documentation accurate and up-to-date

---

Last updated: September 4, 2025