# Install gitea-runner with Homebrew, apk, pacman, winget Official Actions runner for Gitea. Version 2.0.0 via Homebrew; verified 2026-06-30. ## Install ```sh sudo av install brew:gitea-runner ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install gitea-runner ``` Evidence: local Homebrew formula metadata ### Linux - apk (92%): ```sh sudo apk add gitea-runner ``` Evidence: Alpine Linux edge package indexes: gitea-runner from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz - pacman (92%): ```sh sudo pacman -S gitea-runner ``` Evidence: Arch Linux sync databases: gitea-runner from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz ### Windows - winget (92%): ```sh winget install --id Gitea.Runner -e ``` Evidence: Windows Package Manager source index: Gitea.Runner from https://cdn.winget.microsoft.com/cache/source.msix ## Package facts - **Package key:** brew:gitea-runner - **Package manager:** Homebrew - **Package manager page:** - **Version:** 2.0.0 - **Source summary:** Official Actions runner for Gitea - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Last updated:** 2026-06-30T09:48:26Z - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - gitea-runner (cli) - gitea-runner (alias) ## Build dependencies - go ## Install behavior - Post-install hook: not defined - Service: declared - Caveats: Config file: $HOMEBREW_PREFIX/etc/gitea-runner/config.yaml - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 2.0.0 - Package-manager updated: 2026-06-30 - Local data: ok - Upstream repository: https://gitea.com/gitea/runner - info: Release/tag comparison is only available for GitHub repositories. ## Project history and usage Gitea Runner is the official runner for Gitea Actions, the workflow automation system used by Gitea installations. It gives self-hosted Gitea sites a worker process that can register with an instance, accept jobs, and execute GitHub Actions-style workflows through Docker or host execution labels. ### Project history The runner codebase descends from the act-runner effort around Gitea Actions. The official repository's Git history begins in 2019 with support for GitHub Actions-style execution, while the Gitea-runner release stream begins with v0.0.1 in 2023 and reaches the renamed Gitea Runner 1.x and 2.x series in 2026. The project evolved from a companion binary for early Actions support into a documented part of the Gitea platform. Its README and Gitea documentation describe binary, container, Docker-in-Docker, rootless Docker-in-Docker, cache server, label, and post-task-script modes, reflecting the operational concerns of running CI workers for many repositories. ### Adoption history Adoption follows Gitea Actions itself: administrators enable Actions on a Gitea instance, create or obtain runner registration tokens, and attach one or more runner processes to supply build capacity. Packaging in Homebrew, Alpine, Arch, and WinGet makes the runner fit the same self-hosted deployment culture as Gitea. ### How it is used Practitioners use Gitea Runner by generating or supplying a YAML config, registering the runner with a Gitea instance URL and token, then running the daemon. Container deployments often mount the Docker socket or run Docker-in-Docker images so workflow jobs can execute inside job containers. Labels are central to day-to-day use: a label such as an Ubuntu image or a host execution label controls which workflows can target the runner and how jobs are launched. Operators also configure cache behavior, ephemeral runners, registration state, and cleanup scripts when they need repeatable CI nodes. ### Why package nerds care For package-manager users, Gitea Runner is the small binary that turns a packaged Gitea server from code hosting into a self-contained CI system. It matters because it avoids a separate hosted CI dependency while keeping the workflow syntax close to GitHub Actions. ### Timeline - 2019: Runner repository history begins with GitHub Actions-style execution work. - 2023: v0.0.1 appears in the runner release stream. - 2026: v1.0.0 and v2.0.0 mark the renamed Gitea Runner series. ### Related projects - Gitea Runner is closely tied to Gitea, Gitea Actions, workflow files in repositories, and the nektos/act ecosystem that influenced local execution of GitHub Actions workflows. ### Sources - - - ## Security Notes formula declares a Homebrew service. - **Geiger risk:** orange / medium - formula declares a Homebrew service ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: ./config.yaml ## Credential files - Unix: ./.runner ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** gitea-runner - **Version Scheme:** 0 - **Revision:** 0 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Other Package-Manager Records - apk - gitea-runner - 1.0.8-r0: normalized package name match | Alpine Linux edge package indexes: gitea-runner from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Official runner for Gitea | https://gitea.com/gitea/runner - apk - gitea-runner-openrc - 1.0.8-r0: normalized package name match | Alpine Linux edge package indexes: gitea-runner-openrc from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Official runner for Gitea (OpenRC init scripts) | https://gitea.com/gitea/runner - pacman - gitea-runner - 1.0.8-1: normalized package name match | Arch Linux sync databases: gitea-runner from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Official runner for Gitea | https://gitea.com/gitea/runner - winget - Gitea.Runner: normalized package name match | Windows Package Manager source index: Gitea.Runner from https://cdn.winget.microsoft.com/cache/source.msix ## Related links - [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew. - [dagger](https://www.automicvault.com/pkg/brew/dagger/) - Shares av.db curated category or tags: automation, ci-cd, cli, developer-tools. - [gitlab-runner](https://www.automicvault.com/pkg/brew/gitlab-runner/) - Shares av.db curated category or tags: automation, ci-cd, cli, developer-tools, runner. - [jenkins-job-builder](https://www.automicvault.com/pkg/brew/jenkins-job-builder/) - Shares av.db curated category or tags: automation, ci-cd, cli, developer-tools. - [pipelight](https://www.automicvault.com/pkg/brew/pipelight/) - Shares av.db curated category or tags: automation, ci-cd, cli, developer-tools. - [tfcmt](https://www.automicvault.com/pkg/brew/tfcmt/) - Shares av.db curated category or tags: automation, ci-cd, cli, developer-tools. - [act](https://www.automicvault.com/pkg/brew/act/) - Shares av.db curated category or tags: ci-cd, cli, developer-tools. - [brigade-cli](https://www.automicvault.com/pkg/brew/brigade-cli/) - Shares av.db curated category or tags: ci-cd, cli, developer-tools. - [circleci](https://www.automicvault.com/pkg/brew/circleci/) - Shares av.db curated category or tags: ci-cd, cli, developer-tools. - [gitea-mcp-server](https://www.automicvault.com/pkg/brew/gitea-mcp-server/) - Package names and metadata indicate a similar tool family. Shared terms: cli, developer, developer-tools, gitea. - [tea](https://www.automicvault.com/pkg/brew/tea/) - Local package facts share a topical domain. Shared terms: cli, developer, developer-tools, gitea. ## Combined YAML source View the package source record on GitHub. [combined/gitea-runner.yml](https://github.com/automic-vault/db/blob/main/combined/gitea-runner.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph