Files
gitea-migration/runners.conf.example

91 lines
3.6 KiB
Plaintext

# =============================================================================
# runners.conf — Gitea Actions Runner Definitions (INI format)
# Copy to runners.conf and edit, or generate interactively with:
# ./setup/configure_runners.sh
# Use manage_runner.sh to add/remove runners dynamically.
# =============================================================================
#
# Each [section] defines one runner. Section name = runner display name in Gitea.
#
# FIELD REFERENCE:
#
# host — enum: unraid, fedora, local, custom
# Known hosts resolve SSH from .env (IP, user, port, key).
# "local" runs on this machine. "custom" requires extra keys
# in the section: ssh_host, ssh_user, ssh_port, ssh_key.
#
# type — enum: docker, native
# "docker" = Linux container on remote host via Docker Compose.
# "native" = macOS binary + launchd on local machine.
#
# data_path — Absolute path (/ or ~/) where act_runner stores its binary,
# config, and job cache. NOT Gitea's data path.
# Default: RUNNER_DEFAULT_DATA_PATH (docker), LOCAL_RUNNER_DATA_PATH (native)
#
# labels — Workflow runs-on value (e.g. linux, macos, ubuntu-latest).
# Combined with default_image at deploy time to produce
# act_runner label spec: "linux:docker://image" or "macos:host".
#
# default_image — Docker image for job execution (docker runners only).
# Default: RUNNER_DEFAULT_IMAGE from .env.
# If LOCAL_REGISTRY is set, resolved as LOCAL_REGISTRY/image.
# Leave empty for native runners.
#
# repos — Token hint (not an act_runner setting): controls which
# registration token manage_runner.sh fetches at deploy time.
# "all" = instance-level token (runner available to all repos).
# Repo name = fetch repo-level token from Gitea API.
#
# capacity — Positive integer (>= 1). Max concurrent jobs.
# Default: RUNNER_DEFAULT_CAPACITY from .env.
# Constrained by host CPU/RAM. 0 and negative are invalid.
#
# cpu — Docker CPU limit (e.g. 2.0, 0.5). Ignored for native.
# Empty = no limit.
#
# memory — Docker memory limit (e.g. 2g, 512m). Ignored for native.
# Empty = no limit.
#
# boot — enum: true, false (default: false). Native runners only.
# "true" = install launchd plist to /Library/LaunchDaemons/
# (starts at boot before login, requires sudo for install).
# "false" = install to ~/Library/LaunchAgents/
# (starts at login, no sudo needed).
# Ignored for docker runners.
#
# STARTER ENTRIES (uncomment and edit):
#[unraid-runner]
#host = unraid
#type = docker
#data_path = /mnt/nvme/gitea-runner
#labels = linux
#default_image = catthehacker/ubuntu:act-latest
#repos = all
#capacity = 1
#cpu =
#memory =
#[fedora-runner]
#host = fedora
#type = docker
#data_path = /mnt/nvme/gitea-runner
#labels = linux
#default_image = catthehacker/ubuntu:act-latest
#repos = all
#capacity = 1
#cpu =
#memory =
#[macbook-runner]
#host = local
#type = native
#data_path = ~/gitea-runner
#labels = macos
#default_image =
#repos = all
#capacity = 1
#cpu =
#memory =
#boot = false