The SFDMU GUI Desktop Application is a comprehensive tool for Salesforce data migration between SF environments or importing/exporting CSV data into SF environments. It builds upon the capabilities of the SFDX Data Move Utility Plugin (SFDMU), offering a user-friendly interface for seamless data management tasks.
- Knowledgebase and Help Portal: SFDMU Help Center.
- SFDMU GUI Desktop App Detailed Documentation: SFDMU GUI App Reference Guide.
The SFDMU GUI Desktop Application is an open-source and cost-free application that provides numerous advantages, streamlining user workflows and ensuring the secure handling of data:
-
All-In-One Functionality: Users can configure and execute migration tasks seamlessly within the application itself.
-
User-Friendly Interface: The intuitive graphical interface simplifies the creation and management of the
export.jsonfile for the SFDMU Plugin. Even users with limited technical expertise can easily set up complex migration tasks. -
Visual Management: Users can conveniently add, edit, or remove migration components such as sObjects and field mappings. This visual representation facilitates better organization and control over data migration processes.
-
Error Prevention: The application identifies common configuration and metadata errors that may occur during manual editing of the
export.jsonfile. This feature minimizes the risk of errors, thereby enhancing the reliability of data migrations. -
Secure Data Processing: All data processing occurs locally on the user's device, except for interactions with the Salesforce REST API. This approach ensures data security and compliance with stringent privacy regulations and security protocols.
The application is developed using the ElectronJS framework and supports:
- Major operating systems including Windows, macOS, and Linux.
- Requires Windows 10 or newer for Windows users.
- Only x64 CPU architecture is supported.
Installing and running the release version of the SFDMU GUI App is straightforward, even for users with minimal technical expertise.
- All releases were made using the Electron Forge Framework.
- All releases are available on the "release" branch of the SFDMU GUI App GitHub repository.
- You can find the MD5 hash sums in the respective
.md5files located in the same repository folder as the setup file. - Release setup executables are available for versions v4.5.0 and later. Older versions must be installed and run directly from the source code.
- Ensure the SF CLI is installed before using the SFDMU GUI App.
- Install the SFDX Data Move Utility Plugin (SFDMU).
-
Download the latest release of the SFDMU GUI App for your operating system using the following links:
- macOS: Access the
zipinstallation file here: macOS x64 setup. - Linux (Debian-based systems): Access the
debinstallation file here: Debian x64 setup. - Linux (RPM-based systems): Access the
rpminstallation file here: RPM x64 setup. - Windows: Access the
zipfile containing the setup executable here: Windows x64 setup.
- macOS: Access the
-
Follow the steps specific to your operating system for installing the application as detailed in Step 3 below.
For those wishing to run a specific release of the SFDMU GUI App:
Navigate to the repository page, locate the "Releases" section on the sidebar, and click on the release tag associated with your desired version.
Download the appropriate setup file for your OS from the subdirectories under dist/:
-
macOS: Navigate to
dist/darwin/x64/and download the file, e.g.,sfdmu-gui-app-darwin-x64-X.X.X.zip. -
Linux (Debian-based): Go to
dist/deb/x64/and downloadsfdmu-gui-app_X.X.X_amd64.deb. -
Linux (RPM-based): Visit
dist/rpm/x64/and downloadSFDMU-GUI-App-X.X.X-1.x86_64.rpm. -
Windows: Find
dist/windows/x64/and download the zip package, e.g.,sfdmu-gui-app-X.X.X Setup.zip.
Follow the installation instructions provided for each operating system:
- Open
Downloads, find the.zipfile, and extract it to get thesfdmu-gui-app.app. - Move the application to your
Applicationsfolder.
-
Open a terminal.
-
Go to
Downloads:cd ~/Downloads
-
Install with:
sudo dpkg -i sfdmu-gui-app_X.X.X_amd64.deb
-
Open a terminal.
-
Navigate to
Downloads:cd ~/Downloads
-
Install using:
sudo rpm -i SFDMU-GUI-App-X.X.X-1.x86_64.rpm
- Go to the download location, extract the
.zipfile, and runsfdmu-gui-app-X.X.X Setup.exe. - The app will auto-launch after installation, creating shortcuts on your desktop and in the Start menu.
-
Open a Terminal window.
-
Execute the following command to run the application:
/Applications/sfdmu-gui-app.app/Contents/MacOS/sfdmu-gui-app
- Use the application menu to launch the SFDMU GUI App.
- The app typically launches automatically after installation. For later use, locate it via the Start menu or a desktop shortcut.
Alternatively, instead of using the installable executable, you can clone the source code and run the application directly from it. Detailed documentation for this process is available for guidance.