Install Salesforce CLI

Install Salesforce CLI on your computer using operating system-specific artifacts, such as .pkg on macOS, TAR files, or with npm.

Choose one method to install on your computer. For example, don’t install on macOs with both a .pkg file and npm. Installing it both ways can lead to confusing path issues on your computer, sometimes without an explicit error and thus difficult to diagnose.

• Install the CLI on macOS

  Install Salesforce CLI on macOS with a .pkg file.

• Install the CLI on Windows

  Install Salesforce CLI on Windows with an .exe file.

• Install the CLI with a TAR File

  Salesforce CLI distributes TAR files that you can install on all supported operating systems.

• Install the CLI with npm

  If you’ve installed Node.js on your computer, you can use npm to install Salesforce CLI. This method lets you install Salesforce CLI from the command line and can be especially useful for continuous integration (CI) use cases.

• Install Older Versions of Salesforce CLI

  We recommend that you always use the latest version or release candidate of Salesforce CLI. However, we also understand that sometimes you want an older version of the CLI.

• Verify Your Installation and Get Version Information

  To ensure that you’ve installed Salesforce CLI correctly, run these commands to view the version and list of available commands.

Install Salesforce CLI on macOS with a .pkg file.

1. Open the Salesforce CLI download page in your browser.

2. Under macOS, click the download link that applies to the processor of your macOS computer.

   For example, if your processor is Apple Silicon, click Download for macOS (Apple Silicon), which downloads an sf-arm64.pkg file.

3. Run the .pkg file, such as double-clicking it from Finder, and answer all the prompts.

4. After the installation completes, restart your Terminal windows or IDEs to make sure Salesforce CLI is available.

See Also

• Verify Your Installation and Get Version Information
• Disable Automatic Update of the CLI

Install Salesforce CLI on Windows with an .exe file.

1. Open the Salesforce CLI download page in your browser.

2. Under Windows, click the download link that applies to the architecture of your Windows computer.

   For example, if you’re using a 64-bit version of the Windows operating system that’s built for the x86-64 architecture, click Download for Windows x64, which downloads an sf-x64.exe file.

3. Run the .exe file, such as double-clicking it from Windows Explorer, and answer all the prompts.

   (Optional) In the Choose Components window, if you want Microsoft Defender Antivirus to exclude the installed Salesforce CLI files when it scans, select Add %LOCALAPPDATA%\sf to Windows Defender exclusions.

   This option is initially deselected because we want the default Windows installation to be more secure. But excluding the CLI files from the antivirus scans improves the performance of Salesforce CLI, which is why we give you the option. Use with care.

4. After the installation completes, close and then restart all your your command prompts, PowerShell windows, and IDEs to make sure Salesforce CLI is available.

See Also

• Verify Your Installation and Get Version Information
• Disable Automatic Update of the CLI

Salesforce CLI distributes TAR files that you can install on all supported operating systems.

Use this table to find the unversioned URLs for the TAR file (.tar.gz or .tar.xz ) for your operating system. When we release a new version of Salesforce CLI every week, we also update these URLs so they point to the most up-to-date version. Unversioned URLs are especially useful for CI use cases. The table also includes manifest URLs that show the versioned URL for each file.

In these examples it’s assumed that you’re installing Salesforce CLI on Linux and in the cli/sf subdirectory of your home directory.

1. Open a terminal window.

2. Download one of these TAR files. Alternatively, run wget in the terminal to get a TAR file.

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

3. Create the directory where you want to install Salesforce CLI.

   1mkdir -p ~/cli/sf

4. Unpack the contents for your TAR file:

   1tar xJf sf-linux-x64.tar.xz -C ~/cli/sf --strip-components 1

   -C unpacks the contents in the ~/cli/sf directory, while --strip-components 1 removes the root path component.

   This example shows just one possible set of flags for the tar command on Linux. For other options on your operating system, refer to the tar documentation.

   Note

5. Update your PATH environment variable to include the Salesforce CLI bin directory. For example, to set it for your current terminal session:

   1export PATH=~/cli/sf/bin:$PATH

   To update your PATH permanently, add the appropriate entry to your shell’s configuration file. For example, if you use the Bash shell, add this line to your ~/.bashrc or ~/.bash_profile file:

   1PATH=~/cli/sf/bin:$PATH

See Also

• Verify Your Installation and Get Version Information
• Disable Automatic Update of the CLI

If you’ve installed Node.js on your computer, you can use npm to install Salesforce CLI. This method lets you install Salesforce CLI from the command line and can be especially useful for continuous integration (CI) use cases.

This installation method is a good option if you don’t have administrator permissions on your workstation, or if group policy blocks CLI installation and updates. Installing Salesforce CLI with npm doesn’t require root permissions.

1. Open a terminal (macOS and Linux) or command prompt (Windows).

2. Ensure that the long-term support (Active LTS) version of Node.js is installed on your computer. To install the LTS version, go to https://nodejs.org/en/download/. To check your version number, run this command from the terminal or command prompt:

   1node --version

3. To install Salesforce CLI, run this command.

   1npm install @salesforce/cli --global

   If you receive a permission error when installing Salesforce CLI using npm macOS or Linux, we don’t recommend using sudo. See Fixing npm permissions.

See Also

• Verify Your Installation and Get Version Information
• npm Documentation

We recommend that you always use the latest version or release candidate of Salesforce CLI. However, we also understand that sometimes you want an older version of the CLI.

If you installed Salesforce CLI with the installers, update to an older version with the --version flag. For example, to update to version 2.0.1, run this command in a terminal (macOS and Linux) or command prompt (Windows).

1sf update --version 2.0.1

Use the --available flag to list all available older versions to which you can update. The output also shows whether you already have a local copy or if it must be downloaded.

1sf update --available

Use --interactive to choose a version interactively.

Use this command to return to the current version.

1sf update stable

To update to an older version of Salesforce CLI using npm, specify the version using@VERSION after the @salesforce/cli package name. For example, to update to version 2.0.1, run this command in a terminal (macOS and Linux) or command prompt (Windows).

1npm install @salesforce/cli@2.0.1 --global

To return to the current version, run this command.

1npm install @salesforce/cli --global

See the Salesforce CLI npmjs.com page for a list of all versions. We keep all old versions of the @salesforce/cli and sfdx-cli (deprecated) npm packages.

We publish JSON files that list the download URLs for recent versions of the installers and TAR files for each supported operating system. We continually add new versions to the lists; versions remain on the list for 20 weeks. We keep the TAR and installer files themselves for 40 weeks minimum.

To ensure that you’ve installed Salesforce CLI correctly, run these commands to view the version and list of available commands.

1. Open a terminal (macOS and Linux) or a command prompt (Windows) on your computer.

2. To view the Salesforce CLI version that you’ve installed, run this command.

   1sf --version

   The command returns details about the version, such as this example output.

   1@salesforce/cli/2.128.5 darwin-arm64 node-v22.22.0

3. To view the installed core plugins and their versions, run this command.

   1sf plugins --core

   The command displays information such as this sample output.

   1@oclif/plugin-autocomplete 3.2.41 (core)
   2@oclif/plugin-commands 4.1.40 (core)
   3@oclif/plugin-help 6.2.38 (core)
   4@oclif/plugin-not-found 3.2.75 (core)
   5@oclif/plugin-plugins 5.4.58 (core)
   6@oclif/plugin-search 1.2.39 (core)
   7@oclif/plugin-update 4.7.23 (core)
   8@oclif/plugin-version 2.2.38 (core)
   9@oclif/plugin-warn-if-update-available 3.1.55 (core)
   10@oclif/plugin-which 3.2.44 (core)
   11agent 1.32.4 (core)
   12apex 3.9.13 (core)
   13api 1.3.11 (core)
   14auth 4.3.1 (core)
   15data 4.0.80 (core)
   16deploy-retrieve 3.24.16 (core)
   17info 3.4.111 (core)
   18limits 3.3.80 (core)
   19marketplace 1.3.10 (core)
   20org 5.9.72 (core)
   21packaging 2.25.10 (core)
   22schema 3.3.98 (core)
   23settings 2.4.60 (core)
   24sobject 1.4.86 (core)
   25telemetry 3.8.3 (core)
   26templates 56.10.7 (core)
   27trust 3.7.114 (core)
   28user 3.7.1 (core)
   29
   30Uninstalled JIT Plugins:
   31code-analyzer 5.10.2
   32community 3.3.48
   33custom-metadata 3.3.84
   34dev 2.5.2
   35devops-center 1.2.27
   36flow 1.0.5
   37lightning-dev 6.2.16
   38signups 2.6.56
   39@salesforce/sfdx-plugin-lwc-test 1.2.1

4. To view all available Salesforce CLI commands and a summary, run this command.

   1sf commands

5. To display the release notes for the version of Salesforce CLI that’s currently installed on your computer, run this command.

   1sf whatsnew

See Also

• Salesforce CLI Plugins

j

Quick Start

System Requirements

Move from sfdx (v7) to sf (v2)

Install Salesforce CLI

Update Salesforce CLI

Salesforce CLI Configuration and Tips

Uninstall Salesforce CLI or Plugins

Run Salesforce CLI Using a Docker Image

Salesforce CLI Plugins

Troubleshoot Salesforce CLI

CLI Deprecation Policy

Next Steps

Release Notes

Previous PDF Versions