# =============================================================================
# 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.
#
# 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        =