# Gitea-Runner

Gitea-Runner is a self-hosted runner that executes Gitea Actions workflow jobs on your own server using act. It is open source and self-hosted, installable on TrueNAS, Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/554/gitea-runner

## Description

Gitea Runner is a self-hosted runner that executes Gitea Actions workflow jobs on your own server using act.

## Platform availability

Available on 3 of 10 platforms: Unraid, TrueNAS, Proxmox.

## Health score

86/100 (Excellent), based on 3 of 4 factors.
- Maintained: 100 (last commit 12 days ago)
- Popular: 95 (58,982 GitHub stars)
- Easy to install: 45 (2 install platforms, install notes, Docker image)

## Links

- TrueNAS: https://apps.truenas.com/catalog/gitea-act-runner/
- Docker Hub: https://hub.docker.com/r/gitea/act_runner
- GitHub: https://github.com/go-gitea/gitea
- Unraid: https://ca.unraid.net/apps/gitea-runner-1puljwv0h2glgr?q=Gitea-Runner
- Official website: https://gitea.com/gitea/act_runner
- Documentation: https://docs.gitea.com

## Common questions

### How can a local Gitea runner fail to find the Gitea server?

The runner may need to be configured to join the same Docker network as Gitea using the act_runner configuration.

### Do Gitea runner images include Docker-in-Docker variants?

Yes. The release workflow publishes basic, dind, and dind-rootless image targets.

### What Kubernetes backend problem is fixed for copied directories?

The Kubernetes backend extracted CopyDir archives with absolute entries, which could make tar fail with an Invalid cross-device link error on images that link /var/run to /run.

### How does a Windows or macOS setup keep the Gitea runner current?

A boot script can download the latest Gitea Actions runner and execute it from a batch or shell script.

## Alternatives

- Forgejo: Forgejo is a self-hosted, lightweight Git forge for hosting repositories and managing projects.
- GitBucket: GitBucket is a self-hosted Git web platform built in Scala that provides a lightweight GitHub-compatible repository, issue, pull request, a…
- Launchpad: Launchpad is a collaboration and Bazaar code hosting platform for (primarily open-source) software projects.
- Pagure: A Git center project hosting with bug reporting tools.
- Radicle: Open source, peer-to-peer collaboration on Git enables decentralized, censorship-resistant code sharing, local-first autonomy, and modular…
- 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…
- Trac: Trac is an enhanced wiki and issue tracking system for software development projects.
- gitea-mirror: Automatic, private, and free.
- gitness: Gitness is an open-source, self-hosted development platform for code hosting and automated continuous integration, offering small teams and…
- phabricator: Phabricator is a self-hosted collection of web applications for software development, including code review, source control, task tracking,…
- scm-manager: The easiest way to share and manage your Git, Mercurial and Subversion repositories over http.

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