Salesforce CLI Setup Guide

Release Notes
Before You Begin
Install Salesforce CLI
Install the CLI Release Candidate
Run Salesforce CLI Using a Docker Image
Update Salesforce CLI
Salesforce CLI Plug-ins
Salesforce CLI Configuration and Tips
Uninstall Salesforce CLI or Plugins
Troubleshoot Salesforce CLI
CLI Deprecation Policy
Next Steps
Get Started with Salesforce CLI Unification
PDF

Newer Version Available

This content describes an older version of this product. View Latest

Install the CLI Release Candidate

We release a new version of the CLI weekly. At the same time we also publish a release candidate of the CLI that contains changes that we plan to include in the next weekly release. Think of the release candidate as the CLI-version of the Salesforce sandbox preview. You can install a release candidate if you want to check out upcoming features. Or stay on the current and official release. Or go back and forth. It’s up to you!

We recommend you run your continuous integration (CI) jobs against both the current release and the release candidate to identify potential breaking changes before they happen. The current release has the stable tag; the release candidate has the stable-rc tag.

If you’ve already installed the CLI and are using the current release, run this command to switch to the release candidate.

1sfdx update stable-rc

To uninstall the release candidate and return to the current version, run this command.

1sfdx update stable

Install Using npm

Run this command to install the release candidate using npm.

1npm install --global sfdx-cli@latest-rc

To uninstall the release candidate and return to the current version, run this command. 

1npm install --global sfdx-cli@latest

Install from a TAR File

Salesforce CLI distributes TAR files for the release candidate that you can install on all supported operating systems. The download URLs are similar to the URLs for installing the current release, but use the stable-rc channel rather than the stable channel.

For example, to wget the Linux TAR file for the release candidate, run this command, which downloads from the stable-rc channel.

1wget https://developer.salesforce.com/media/salesforce-cli/sfdx/channels/stable-rc/sfdx-linux-x64.tar.xz

Other than using a different channel, the instructions for installing the release candidate from a TAR file are the same as the instructions for installing the current release.