1
0
Fork 0
1Panel-Appstore/apps/action-runner
renovate[bot] d56d9cc4a7
chore(deps): update ghcr.io/pooneyy/actions-runner docker tag to v2.332.0 (#4213)
2026-02-25 19:12:30 +00:00
..
2.332.0 chore(deps): update ghcr.io/pooneyy/actions-runner docker tag to v2.332.0 (#4213) 2026-02-25 19:12:30 +00:00
README.md 📝 docs(action-runner): update documentation structure and content 2025-12-26 12:26:43 +08:00
README_en.md 📝 docs(action-runner): update documentation structure and content 2025-12-26 12:26:43 +08:00
data.yml Update action runner metadata and add descriptions 2025-10-01 17:46:34 +08:00
logo.png (feat) Add app action-runner 2025-10-01 16:33:31 +08:00

README_en.md

Introduction

A simple self-hosted actions runner running in a container

Features

  • Supports Docker-out-of-Docker

  • Built-in github-cli python pip yq

Configuration and Usage Instructions

Parameter Required Description
ROLE Required Used to differentiate between enterprise, organization, and personal repositories.
Use enterprises for enterprise, orgs for organization, and repos for personal repositories.
REST API
REPO Required Format for enterprise: enterpriseName
Format for organization: orgName
Format for personal repository: owner/repo
REST API
RUNNER_GITHUB_TOKEN Required Fine-grained PAT is recommended.
For enterprises:
Fine-grained PAT cannot be used for enterprises
OAuth app tokens and PAT (classic) require the manage_runners:enterprise permission.
For organizations:
Fine-grained PAT should have read and write permissions for Self-hosted runners.
OAuth tokens and PAT (classic) require admin:org permissions,
additionally, repo permissions are required for private organization repositories.
For personal repositories:
Fine-grained PAT should have read and write permissions for Administration.
OAuth tokens and PAT (classic) require repo permissions.
How to create a token?
REST API
RUNNER_NAME Runner name. If left empty, it will be randomly generated.
Runner names must be unique within the same personal repository (or enterprise/organization).
RUNNER_LABELS Runner labels. Filling this will add new labels..
Use commas to separate multiple labels.
Example: label1,label2
WORK_FOLDER Working directory. If left empty, it will be randomly generated. Rarely needed.
RUNNER_GROUP Runner group. The default value is Default. For details, refer to the documentation.
AUTO_UNREGISTER Whether to unregister the Runner from github.com when the container stops.
Default is false. It is recommended to map /home/runner/.runner_config
to a local when selecting false. This folder saves Runner's login status.

For parameters marked with REST API, refer to the documentation.