jbrazio/github-runner-debian

Easily configure and deploy custom Github Actions runners with customizable settings for seamless integration with your organization's workflow.

GitHub Runner Debian

GitHub Runner Debian is a project designed to create and manage self-hosted runners on Debian systems for GitHub workflows. These runners allow you to execute your GitHub Actions workflows directly on your own infrastructure, providing greater control, performance, and flexibility.

Features

• Self-Hosted Runner: Deploy an Debian-based self-hosted runner to execute your GitHub workflows.
• Customizable Environment: Tailor the runner environment to meet your specific needs, including custom software and configurations.
• Cost-Effective: Utilize existing infrastructure, potentially reducing costs associated with GitHub-hosted runners.
• Enhanced Performance: Improve workflow execution time by using more powerful or locally optimized hardware.
• Increased Security: Keep sensitive data within your own network by hosting runners internally.

Prerequisites

Before setting up a GitHub Runner Debian, ensure you have the following:

• A Docker server instance with network access.
• Administrative privileges to install necessary packages and make system configurations.
• A GitHub account with repository access to set up and manage actions.

Installation and Setup

1. Clone the Repository

   Start by cloning this repository to your local machine or server:

   git clone https://github.com/jbrazio/github-runner-debian.git
   cd github-runner-debian

2. Configure the Runner

   Locate the docker-compose.example file and update the required settings, including the runner token and organization. After making the necessary changes, rename it to docker-compose.yaml.

3. Start the Runner

   Start the runner to begin processing workflows:

   docker compose up -d

Usage

Once the runner is set up and running, you can add .yml workflow files in your GitHub repository to start using the runner. Customize the workflows to leverage your self-hosted runner's capabilities.

Troubleshooting

• Runner Fails to Start: Ensure all dependencies are installed and configurations in docker-compose.yaml are correctly set.
• Performance Issues: Optimize your server hardware or configuration for better performance.

Contributing

Contributions to this project are welcome! Feel free to open issues or submit pull requests with enhancements and bug fixes.

License

This project is licensed under the GPLv3 License. See the LICENSE file for details.