Gitea-Runner

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

  • Cloud
  • Development
  • Productivity
  • Tools & Utilities
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
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

86/100 Excellent

Maintained
100last commit 12 days ago
Popular
9558,982 GitHub stars
Easy to install
452 install platforms, install notes, Docker image
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today, links checked 53 days ago

GitHub stars
58,982
Open issues
2176
Last commit
2026-11-09
Latest release
v28.3.0
License
MIT
Activity
rising

Checked 12 days ago - source: GitHub (go-gitea/gitea)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Start Gitea before the runner runs Start the Gitea web server before registering the runner, for example with gitea web. If Gitea is stopped, the runner cannot connect and jobs will not start. source
  • Tell pip where Gitea packages live For pip installs, set the --index-url flag (where pip looks for packages) to your Gitea package URL and include your user name and password. If the URL is wrong, pip will search other places and fail to find your private package. source
  • Point Go at your Gitea proxy If your project uses Go modules, set GOPROXY (the Go package mirror address) to your Gitea package URL. Without this, Go will use its default public proxy and not find packages hosted in Gitea. source

Fetched 37 days ago - each note links to its source

Alternatives (12)

  • 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.

Checked 51 days ago - source: AlternativeTo

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.

Answers sourced from gitea.com, stackoverflow.com, www.redditmedia.com

Community

Collected 49 days ago - public community threads