# Forgejo Runner

Forgejo Runner is a self-hosted continuous integration / continuous deployment (CI/CD) runner that executes automated Forgejo Actions workflows, letting you run build, test, and deploy jobs for your repositories on a. It is open source and self-hosted, installable on TrueNAS, Proxmox, Kubernetes (Helm) and Unraid.

Canonical page: https://ourlocalhost.com/app/4426/forgejo-runner

## Description

Forgejo Runner is a self-hosted continuous integration / continuous deployment (CI/CD) runner that executes automated Forgejo Actions workflows, letting you run build, test, and deploy jobs for your repositories on a Forgejo instance (defaulting to Codeberg).

## Platform availability

Available on 4 of 10 platforms: Unraid, TrueNAS, Proxmox, Helm.

## Health score

60/100 (Good), based on 5 of 5 factors.
- Maintained: 65 (last commit 131 days ago)
- Popular: 35 (56 GitHub stars)
- Easy to install: 65 (4 install platforms, install notes, Docker image)
- Light to run: 50 (2 GB minimum RAM)
- Security check: 85 (no serious findings, CI)

## Links

- Documentation: https://forgejo.org/docs/next/admin/actions/runner-installation/
- TrueNAS: https://apps.truenas.com/catalog/forgejo-runner/
- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=forgejo-runner
- Kubernetes (Helm): https://artifacthub.io/packages/helm/forgejo-runner/forgejo-runner
- Official website: https://forgejo.org/
- Unraid: https://ca.unraid.net/apps/forgejorunner-18gnblz1ql5her?q=ForgejoRunner
- GitHub: https://github.com/Crown0815/Forgejo-runner-windows-builder

## Common questions

### Can multiple Forgejo Runner installations connect to the same Forgejo instance?

Yes, multiple runner installations can connect to a single Forgejo instance to distribute jobs across available compute resources.

### What security risk is associated with running Forgejo Runner?

Forgejo Runner performs remote code execution, which poses significant security threats to the host and network it operates upon.

### Why does a job using a private container image stop before any step runs?

The runner cannot pull the image unless the job includes the registry username and password in its container credentials block.

### Why can't a job find a helper service such as a database?

Use the service key you assigned to the service as the hostname in your commands; mismatched names prevent the command from finding the service.

### How can workflows target a specific runner?

Use custom labels to target specific runners, such as labels for Windows-specific jobs.

## Alternatives

- Gerrit: Gerrit is an open-source, web-based code review and project management platform for Git repositories that enables development teams to coll…
- GitBucket: GitBucket is a self-hosted Git web platform built in Scala that provides a lightweight GitHub-compatible repository, issue, pull request, a…
- GitHub: Web-based Git hosting service facilitating collaboration, with features like issue tracking, social networking, and wikis for project manag…
- GitLab: GitLab is a self-hosted Git repository server and software delivery platform for individuals and teams to privately plan, version, build, t…
- RhodeCode: RhodeCode is a self-hosted code review and repository management platform for Git, Subversion, and Mercurial.
- SourceForge: Open source community and software directory offering code hosting, analytics, version control, project management, and access to over 50,0…
- gitness: Gitness is an open-source, self-hosted development platform for code hosting and automated continuous integration, offering small teams and…

---
Source: Our Local Host (https://ourlocalhost.com/app/4426/forgejo-runner), the self-hosted and open-source app directory.
