GT-UPGRADE(1) gitea-cli Manual GT-UPGRADE(1)

gt-upgrade - Upgrade gt to its latest release

gt upgrade [flags]

Upgrade gt to its latest release, to the release --version names, or to the latest build of the main branch with --nightly. gt downloads the build for this system from dl.gitea.com, like the install script, verifies its SHA-256 checksum and replaces its executable with it; GITEA_CLI_DOWNLOAD_URL selects another download location.

gt installed with Homebrew, a Linux package, Nix or go install is upgraded the way it was installed; gt upgrade names the command for that instead.

After a command, gt tells at most once a day when a newer release is out, asking gitea.com for it. It does not check in CI or when stdout or stderr is not a terminal; set GITEA_CLI_NO_UPDATE_NOTIFIER to turn the check off.

--dry-run[=false] Show the upgrade without installing it

--force[=false] Reinstall the current version too

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

--nightly[=false] Install the latest build of the main branch

--version="" Install this release instead of the latest one

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

-y, --yes[=false] Accept confirmations without prompting

$ gt upgrade
# See whether a newer release is out
$ gt upgrade --dry-run
$ gt upgrade --version 1.0.0 --yes
$ gt upgrade --nightly

gt(1)

Nov 2026 gitea-cli