Update Salesforce CLI

Determine How You Installed Salesforce CLI

Because the method to update or uninstall Salesforce CLI differs depending on whether you used the operating system-specific installers or npm, you must know how you installed before you can update or uninstall. In case you forgot, here are some tips.

• Run sf update in a terminal (macOS and Linux) or command prompt (Windows). If Salesforce CLI successfully updates, then you installed with the installers. If the command returns this or similar warning, then you installed with npm:
  1sf update
  2 ›   Warning: Use "npm update --global @salesforce/cli" to update npm-based installations.
  3@salesforce/cli: Updating CLI... not updatable

  If you get an error similar to this one, then you’re probably still using sf (v1), which was bundled with sfdx (v7):

  1Running "sf update" has no effect because you're using a version of sf that was installed by sfdx.

  Both sf (v1) and sfdx (v7) are deprecated, so see Move from sfdx (v7) to sf (v2) for information on how to move to the latest supported version of Salesforce CLI, which is sf (v2).

• Run npm list -g --depth 0. If you got valid output, and the displayed list includes the entry @salesforce/cli@<version>, then you installed Salesforce CLI with npm.

If You Installed Salesforce CLI Using the Installer

1sf update

By default, the CLI periodically checks for and installs updates. To disable auto-update, set the SF_AUTOUPDATE_DISABLE environment variable to true.

When you update Salesforce CLI, we automatically display the release notes for the version you're updating to so you can learn about the new, changed, and fixed features. To silence the display, set the SF_HIDE_RELEASE_NOTES and SF_HIDE_RELEASE_NOTES_FOOTER environment variables to true.

If You Installed Salesforce CLI Using npm

1npm install --global @salesforce/cli

What Happens When You Update Salesforce CLI?

As previously described, you can update Salesforce CLI using two methods: sf update or npm install --global @salesforce/cli. Let's break down the upgrade process for both methods. See Salesforce CLI Plugins for terminology and architecture information about plugins.

Common Updates for Both Methods

• Salesforce CLI: Updated to the latest version, which is the public @salesforce/cli npm package that has the latest tag.
• Core plugins: All core plugins are also updated to their latest versions based on the latest tag. Examples include @salesforce/plugin-org and @salesforce/plugin-deploy-retrieve.

Update Behavior of Non-Core Plugins

• If you used sf update to update Salesforce CLI, then the update process attempts to update all non-core plugins to their latest available versions. Specifically, the process updates a non-core plugin only if the currently-installed one is older than the latest version. If the installed non-core plugin is newer than the latest version, then this plugin isn't updated.

  For example, let's say the latest available version of the code-analyzer plugin is 5.3.0. If the installed version is 5.3.1, then the code-analyzer plugin isn't updated when you run sf update. If, however, if the installed version is 5.2.0, then the plugin is updated to 5.3.0.

• If you used npm install --global @salesforce/cli to update, then the non-core plugins (JIT and user-installed) aren't updated. You must update them yourself manually.