gt-runner-token(1)

gt-runner-token1

Print the runner registration token

Usage

gt runner token [flags]

Overview

Print the token that registers new runners with the repository, organization, account or instance. Gitea creates it on first use and returns the same one until it is reset in the web interface. Anyone with the token can register a runner there, and runners receive the jobs and secrets of that scope, so treat it as a secret.

Json fields

token

Options

-h, --help[=false]
help for token

Options inherited from parent commands

--account[=false]
Manage the runners of your account

--csv[=""]
Output CSV with the specified comma-separated fields, or all fields

--cwd=""
Working directory for repository discovery

--debug[=false]
Log the method, URL, status, and duration of each HTTP request to stderr

--global[=false]
Manage the runners of the instance (administrators)

--host=""
Gitea instance URL, including any base path

--interactive[=false]
Allow prompts with machine output

-q, --jq=""
Filter JSON output using a jq expression; implies --json

--json[=""]
Output JSON with the specified comma-separated fields, or all fields

--no-input[=false]
Disable prompts and implicit editor/browser interactions

--org=""
Manage the runners of an organization

--remote=""
Git remote used for repository discovery

-R, --repo=""
Select a repository as OWNER/REPO or URL

--sudo=""
Perform API requests as this user (requires an administrator account)

--user=""
Account name on the selected instance

Examples

$ gt runner token
$ gitea-runner register --no-interactive --instance https://gitea.example.com --token "$(gt runner token --org acme)"

From gitea-cli 1.0.0-1 in Arch Linux 2026-11-07. Parsed by carta from the page's man source.