| GT-UPGRADE(1) | gitea-cli Manual | GT-UPGRADE(1) |
NAME
gt-upgrade - Upgrade gt to its latest release
SYNOPSIS
gt upgrade [flags]
DESCRIPTION
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.
OPTIONS
--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
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
-y, --yes[=false] Accept confirmations without prompting
EXAMPLE
$ gt upgrade # See whether a newer release is out $ gt upgrade --dry-run $ gt upgrade --version 1.0.0 --yes $ gt upgrade --nightly
SEE ALSO
| Nov 2026 | gitea-cli |