.nh
.TH "GT-RUNNER-TOKEN" "1" "Nov 2026" "gitea-cli" "gitea-cli Manual"

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


.SH SYNOPSIS
\fBgt runner token [flags]\fP


.SH 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.

.SS JSON FIELDS
.EX
token
.EE


.SH OPTIONS
\fB-h\fP, \fB--help\fP[=false]
	help for token


.SH OPTIONS INHERITED FROM PARENT COMMANDS
\fB--account\fP[=false]
	Manage the runners of your account

.PP
\fB--csv\fP[=""]
	Output CSV with the specified comma-separated \fBfields\fR, or all fields

.PP
\fB--cwd\fP=""
	Working \fBdirectory\fR for repository discovery

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

.PP
\fB--global\fP[=false]
	Manage the runners of the instance (administrators)

.PP
\fB--host\fP=""
	Gitea instance \fBURL\fR, including any base path

.PP
\fB--interactive\fP[=false]
	Allow prompts with machine output

.PP
\fB-q\fP, \fB--jq\fP=""
	Filter JSON output using a jq \fBexpression\fR; implies --json

.PP
\fB--json\fP[=""]
	Output JSON with the specified comma-separated \fBfields\fR, or all fields

.PP
\fB--no-input\fP[=false]
	Disable prompts and implicit editor/browser interactions

.PP
\fB--org\fP=""
	Manage the runners of an organization

.PP
\fB--remote\fP=""
	Git \fBremote\fR used for repository discovery

.PP
\fB-R\fP, \fB--repo\fP=""
	Select a repository as \fBOWNER/REPO\fR or URL

.PP
\fB--sudo\fP=""
	Perform API requests as this \fBuser\fR (requires an administrator account)

.PP
\fB--user\fP=""
	Account \fBname\fR on the selected instance


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


.SH SEE ALSO
\fBgt-runner(1)\fP