Salesforce CLI Setup Guide

Before You Begin
Install Salesforce CLI
Install the CLI Release Candidate
Install Salesforce CLI Plug-Ins
Update Salesforce CLI
Salesforce CLI Configuration and Tips
Uninstall Salesforce CLI or Plug-Ins
Troubleshoot Salesforce CLI
CLI Deprecation Policy
Next Steps
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.

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

When the update completes, you also have the release candidates for the core Salesforce CLI plug-ins, such as salesforcedx.

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.