brew-upgrade

brew upgrade [options] [formula|cask] ...

brew upgrade upgrades outdated casks and outdated, unpinned formulae using the same options they were originally installed with. Without arguments, it upgrades all installed packages. With arguments, it upgrades only the specified packages.Unless $HOMEBREW_NO_INSTALLED_DEPENDENTS_CHECK is set, brew upgrade or brew reinstall will be run for outdated dependents and dependents with broken linkage, respectively.Unless $HOMEBREW_NO_INSTALL_CLEANUP is set, brew cleanup will then be run for the upgraded formulae or, every 30 days, for all formulae.

--formula, --formulae

Treat all named arguments as formulae. If no named arguments are specified, upgrade only outdated formulae.

Treat all named arguments as casks. If no named arguments are specified, upgrade only outdated casks.

Show what would be upgraded, but do not actually upgrade anything.

Print the verification and post-install steps.

Make some output more quiet.

If brewing fails, open an interactive debugging session with access to IRB or a shell inside the temporary build directory.

Print install times for each package at the end of the run. Enabled by default if $HOMEBREW_DISPLAY_INSTALL_TIMES is set.

Ask for confirmation before downloading and upgrading formulae. Print download, install and net install sizes of bottles and dependencies. Enabled by default if $HOMEBREW_ASK is set.

Install formulae without checking for previously installed keg-only or non-migrated versions. When installing casks, overwrite existing files (binaries and symlinks are excluded, unless originally from the same cask).

Also include casks with auto_updates true or version :latest. Enabled by default if $HOMEBREW_UPGRADE_GREEDY is set.

Also include casks with version :latest.

Also include casks with auto_updates true.

Fetch the upstream repository to detect if the HEAD installation of the formula is outdated. Otherwise, the repository's HEAD will only be checked for updates when a new stable or development version has been released.

Compile formula from source even if a bottle is available.

Install from a bottle if it exists for the current or newest version of macOS, even if it would not normally be used for installation.

Skip installing cask dependencies.

Delete files that already exist in the prefix while linking.

Retain the temporary files created during installation.

HOMEBREW_NO_INSTALLED_DEPENDENTS_CHECK

Skip upgrading outdated dependents and dependents with broken linkage.

Skip automatic cleanup after upgrade.

Enables --display-times by default.

Enables --ask by default.

Enables --greedy by default.

Run brew update first to fetch the latest package definitions before upgrading. Cask upgrades may use an uninstall/reinstall or content replacement strategy depending on the cask. Pinned formulae are never upgraded; use brew unpin to allow upgrades.

brew(1), brew-update(1), brew-outdated(1), brew-install(1), brew-reinstall(1), brew-cleanup(1)