---
name: "gt-config"
section: "1"
platform: "linux"
package: "gitea-cli"
version: "1.0.0-1"
release: "Arch Linux 2026-11-07"
platforms: ["linux"]
url: "https://carta.tech/man/gt-config"
---

# gt-config(1)

Manage settings

## NAME

gt-config - Manage settings

## SYNOPSIS

**gt config \[flags\]**

## DESCRIPTION

Manage gt's settings.

Preferences live in config.yml and instance settings in hosts.yml, in the configuration directory ($GITEA\_CLI\_CONFIG\_DIR, or gitea-cli under the XDG config directory); gt config path prints both files. Environment variables that override settings are listed in gt help environment.

Preferences: default\_host, git\_protocol, editor, prompt (enabled or disabled), pager, browser (never disables opening), color, hyperlinks and markdown (auto or raw), remote, http\_timeout, extensions (enabled or disabled), extension\_hosts, extension\_owners and aliases (see gt alias). Instance settings (--host \<url\>): user, ssh\_host, insecure, git\_protocol, oauth\_client\_id, headers, client\_cert and client\_key. Account settings (--host \<url\> --user \<name\>): ssh\_key, ssh\_agent, ssh\_certificate\_principal, ssh\_key\_fingerprint.

## OPTIONS

**-h**, **--help**\[=false\]\
 	help for config

## OPTIONS INHERITED FROM PARENT COMMANDS

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

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

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

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

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

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

## SEE ALSO

**[gt(1)](/man/gt/1.md)**, **[gt-config-get(1)](/man/gt-config-get/1.md)**, **[gt-config-list(1)](/man/gt-config-list/1.md)**, **[gt-config-path(1)](/man/gt-config-path/1.md)**, **[gt-config-set(1)](/man/gt-config-set/1.md)**