.nh
.TH "GT-CONFIG-SET" "1" "Nov 2026" "gitea-cli" "gitea-cli Manual"

.SH NAME
gt-config-set - Change a setting


.SH SYNOPSIS
\fBgt config set <key> <value> [flags]\fP


.SH DESCRIPTION
Change a preference, an instance setting (--host) or an account setting (--host and --user).

.PP
Preferences:
  default_host    instance to use when no flag or repository selects one
  git_protocol    https or ssh, for clones and remotes
  editor          command that edits bodies and messages, such as "code --wait"
  prompt          enabled or disabled; disabled turns prompts off
  pager           command that pages long output on a terminal; GITEA_CLI_PAGER overrides it
  browser         command that opens URLs; never disables opening
  color           auto, always or never
  hyperlinks      auto, always or never, for clickable links in terminals
  markdown        auto renders Markdown on a terminal, raw prints the source
  remote          Git remote tried first to find the repository of a clone and to push to
  http_timeout    longest wait for the instance to answer a request, such as 30s, or for more
                  data while a transfer stalls; 0 waits as long as it takes; a transfer that
                  keeps moving and migrations are not cut off. The wait for an answer starts
                  once an upload has reached the instance's machine, so an instance that reads
                  uploads slowly from its connection needs a longer timeout
  extensions      enabled or disabled; disabled refuses to install or run extensions
  extension_hosts, extension_owners
                  comma-separated instance URLs, or HOST/OWNER such as
                  https://gitea.com/gitea, that extensions may come from; empty allows any

.PP
Instance settings: ssh_host, insecure, git_protocol, oauth_client_id, and headers: "Name: value"
adds a header to every API request to the instance, such as an access proxy needs, "Name:"
removes it, and a value of $NAME or ${NAME} is read from that environment variable when sent;
client_cert and client_key name the PEM files of a TLS client certificate for an instance that
requires one; without client_key, the key is read from client_cert, and clearing client_cert
clears client_key. The active account (user) changes with gt auth switch.
Account settings: ssh_key, ssh_agent, ssh_certificate_principal, ssh_key_fingerprint. As in Git,
GIT_SSH_COMMAND in the environment takes precedence over ssh_key.


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


.SH OPTIONS INHERITED FROM PARENT COMMANDS
\fB--debug\fP[=false]
	Log the method, URL, status, and duration of each HTTP request to stderr

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

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

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

.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 config set editor "code --wait"
$ gt config set ssh_host git.example.com:2222 --host https://example.com
$ gt config set ssh_key ~/.ssh/id_ed25519 --host https://example.com --user alice
.EE


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