GT-RUNNER-TOKEN(1)             gitea-cli Manual             GT-RUNNER-TOKEN(1)



NAME
       gt-runner-token - Print the runner registration token



SYNOPSIS
       gt runner token [flags]



DESCRIPTION
       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



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



SEE ALSO
       gt-runner(1)

gitea-cli                          Nov 2026                 GT-RUNNER-TOKEN(1)