---
name: "gt-upgrade"
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-upgrade"
---

# gt-upgrade(1)

Upgrade gt to its latest release

## 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)](/man/gt/1.md)**