Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

upgrade

package

Go to main page

Versions in this module

v1

v1.1.11

Sep 23, 2026

v1.1.10

Sep 15, 2026

v1.1.9

Sep 14, 2026

Changes in this version

+ func UpdateCheckFailureBackoff() time.Duration

+ func UpdateCheckTTL() time.Duration

v1.1.8

Sep 10, 2026

v1.1.7

Sep 8, 2026

v1.1.6

Sep 7, 2026

v1.1.5

Aug 31, 2026

v1.1.4

Aug 27, 2026

v1.1.3

Aug 14, 2026

v1.1.2

Aug 13, 2026

Changes in this version

+ const CheckHTTPTimeout

+ const DefaultHTTPTimeout

+ const EnvDisableUpdateCheck

+ const EnvDownloadBaseURL

+ const EnvInstallMethod

+ const EnvUpdateCheckTTLHours

+ const HomebrewFormula

+ const InternalUpgradeCleanupCommand

+ const InternalUpgradeEnvironment

+ const InternalUpgradeHelperCommand

+ const NPMPackage

+ var ConfigDirFunc = defaultConfigDir

+ func ArchiveName(version, goos, goarch string) string

+ func BinaryName() string

+ func CDNBaseURL() string

+ func CheckCachePath() (string, error)

+ func ChecksumForArchive(content, archiveName string) (string, error)

+ func ChecksumName(version string) string

+ func DoUpgrade(opts Options) error

+ func DownloadFile(w io.Writer, url, destPath string) error

+ func ExtractBinaryFromZip(archivePath, destPath, binaryName string) error

+ func FetchURLBytes(client *http.Client, url string, limit int64) ([]byte, error)

+ func FileSHA256(path string) (string, error)

+ func FormatUpgradeNotice(current, latest string) string

+ func FormatUpgradeNoticeFor(current, latest string, info InstallInfo) string

+ func HomebrewUpgradeCommand() string

+ func InvalidateCheckCache()

+ func IsNewer(current, latest string) bool

+ func IsZipPath(path string) bool

+ func LaunchWindowsUpgradeHelper(opts WindowsUpgradeLaunchOptions) error

+ func LoadCheckCache() (versionCheckCache, bool)

+ func MaybePrintUpgradeNotice(stderr *os.File, currentVersion string, ac *AsyncCheck)

+ func NPMUpgradeCommand(pinVersion string) string

+ func NormalizeVersion(version string) string

+ func OfficialReleasesURL() string

+ func ParseChecksumEntries(content string) (map[string]string, error)

+ func ReplaceBinary(newPath, currentPath string) error

+ func ReplaceBinaryWithBackup(newPath, currentPath, expectedVersion string) error

+ func ResolveExecPath() (string, error)

+ func ResolveLatestVersion() (string, error)

+ func ResolveLatestVersionQuick() (string, error)

+ func RollbackBinary(backupPath, currentPath string) error

+ func RunWindowsUpgradeCleanup(parentPID int, workDir string) error

+ func RunWindowsUpgradeHelper(opts WindowsUpgradeHelperOptions) error

+ func SameVersion(a, b string) bool

+ func SaveCheckCache(latest, current string) error

+ func SaveCheckFailure(previousLatest, current string) error

+ func SelfCheckVersion(path, expectedVersion string) error

+ func SetCheckHTTPClient(c *http.Client)

+ func SetHTTPClient(c *http.Client)

+ func ShouldSkipBackgroundCheck(args []string) bool

+ func UpdateCheckDisabled() bool

+ func ValidateVersion(version string) error

+ func VerifyFileChecksum(path, expectedHex string) error

+ type AssetSource struct

+ ArchiveName string

+ ArchiveURL string

+ ChecksumName string

+ ChecksumURL string

+ Version string

+ func ResolveAssetSource(version string) (*AssetSource, error)

+ type AsyncCheck struct

+ func StartBackgroundCheck(currentVersion string, args []string) *AsyncCheck

+ func (a *AsyncCheck) TryResult() (CheckResult, bool)

+ func (a *AsyncCheck) Wait(timeout time.Duration) CheckResult

+ type CheckResult struct

+ CheckedAt time.Time

+ Current string

+ Err error

+ FromCache bool

+ HasUpdate bool

+ Latest string

+ func CheckForUpdate(currentVersion string) CheckResult

+ type DetectContext struct

+ ExecPath string

+ LookupEnv func(string) string

+ type DetectedBy string

+ const DetectedByDefault

+ const DetectedByEnv

+ const DetectedByPath

+ type Detector interface

+ Info func(execPath string) InstallInfo

+ Match func(normalizedPath string) bool

+ Method func() Method

+ type InstallInfo struct

+ DetectedBy DetectedBy

+ DisplayName string

+ ExecPath string

+ Method Method

+ UpgradeCmd string

+ func DetectInstall(execPath string) InstallInfo

+ func DetectInstallFromRunningBinary() InstallInfo

+ func (i InstallInfo) Managed() bool

+ type Method string

+ const MethodHomebrew

+ const MethodNPM

+ const MethodStandalone

+ type Options struct

+ CurrentVersion string

+ ExecPath string

+ SkipSelfCheck bool

+ Stderr io.Writer

+ Stdin io.Reader

+ Stdout io.Writer

+ TargetVersion string

+ Yes bool

+ type VersionManifest struct

+ Channels struct{ ... }

+ Latest string

+ MinSupported string

+ SecurityUpdate bool

+ type WindowsUpgradeHelperOptions struct

+ CurrentVersion string

+ ExpectedVersion string

+ ExplicitTarget bool

+ NewBinaryPath string

+ ParentPID int

+ SkipSelfCheck bool

+ Stderr io.Writer

+ Stdout io.Writer

+ TargetPath string

+ WorkDir string

+ type WindowsUpgradeLaunchOptions struct

+ CurrentExecutable string

+ CurrentVersion string

+ ExpectedVersion string

+ ExplicitTarget bool

+ NewBinaryPath string

+ SkipSelfCheck bool

+ Stderr io.Writer

+ Stdout io.Writer

+ TargetPath string

+ WorkDir string