Installation.

Table of Contents



Prerequisites. ⇧

Before you install and use the SFDMU Plugin, ensure that the SF CLI is installed on your system.

If you wish to use the source code of the SFDMU Plugin, you must also install Node.js and Git.

Installation. ⇧

Installation as a SFDX Plugin ⇧

The simplest and recommended method is installing SFDMU as an SF CLI plugin (historically referred to as an SFDX plugin). This uses the production version of the plugin:

# Uninstall any old versions of the plugin:
$ sf plugins uninstall sfdmu

# Install the latest version of the plugin:
$ sf plugins install sfdmu

Installation from Cloned Source Code (for Debugging) ⇧

For debugging purposes, you can install the plugin from source code:

# Unlink any old linked source code:
$ sf plugins unlink sfdmu

# Clone the latest source code:
$ git clone https://github.com/forcedotcom/SFDX-Data-Move-Utility

# Navigate to the installation directory:
$ cd SFDX-Data-Move-Utility

# Install required npm modules:
$ npm install

# Link the plugin to the SF CLI:
$ sf plugins link
Notes:

  • MacOS Users: If you encounter permission issues, prepend commands with sudo, e.g., $ sudo sf plugins install sfdmu.

  • CLI Version Compatibility: SFDMU is documented and supported with the modern sf CLI command format. Legacy sfdx command style is deprecated.

  • If you have already installed the SFDMU plugin as an SFDX Plugin using sf plugins install sfdmu, you do not need to execute sf plugins link on the local repository directory if your intention is merely to use the source code for debugging purposes.

Related Articles ⇧

Last updated on 17th Feb 2026