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
       gt(1)

gitea-cli                          Nov 2026                      GT-UPGRADE(1)