# Deploy Github Actions Runner with Easypanel

URL: /templates/github-actions-runner

A GitHub Actions runner is a service that runs the jobs defined in your GitHub workflows.
This image is based on Linux 24.04

## Installation notes

Go to your GitHub repository or organization. Navigate to Settings > Actions > Runners. Click Add Runner and copy the registration token provided.

## Benefits

### Full Environment Control

Customize the operating system, tools, and dependencies to match your project needs

### Persistent Resources

Keep build caches and artifacts between runs for faster execution

### Private Network Access

Run jobs inside secure environments with access to internal services and databases

### Cost Efficiency

Reduce reliance on GitHub-hosted runners by using your own infrastructure

## Features

### Custom Environment Setup

Install and configure any tools, libraries, or runtimes required for your workflows

### Hardware Flexibility

Run jobs on your own servers, virtual machines, or even specialized hardware like GPUs

### Persistent Storage

Retain build artifacts, logs, and caches between workflow runs

### Secure Network Integration

Connect workflows directly to internal systems and private databases

### Scalable Infrastructure

Register multiple runners to balance load and handle parallel jobs

### Long-running Jobs

Support workflows that require more time than GitHub-hosted runners allow

### Custom Labels

Tag runners with labels to target specific jobs and environments

## Configuration

- `appServiceName` (App Service Name, required): gha-runner

- `appServiceImage` (App Service Image, required): latest-x64 / latest-arm64

- `githubRepoUrl` (Github Repository Link, required): https://github.com/<your-repo>

- `githubRepoToken` (Github Repository Token, required): <your-runner-token>

## Services

- gha-runner: app (leogomide/gha-runner:latest-x64)

## Resources

- [Website](https://github.com/actions/runner)

- [Documentation](https://docs.github.com/en/actions/concepts/runners/self-hosted-runners)

- [GitHub](https://github.com/leogomide/gha-runner)

- [Docker Hub](https://hub.docker.com/r/leogomide/gha-runner)

- [Environment Variables](https://github.com/leogomide/gha-runner)

- [Template source](https://github.com/easypanel-io/templates/tree/main/templates/github-actions-runner)