Installing the CopyStorm Dashboard takes a few minutes and does not touch any system files or registry values. You should not need an administrator.

• Ensure that you have the CopyStorm/Restore installed.

  • You will need version 10.54.2 or newer.

• Contact CapStorm to request the package.- Open CopyStorm/Restore.

  • Open the “File” menu in the top left corner of the application UI, and select the “Load Package” option.

  • Open the downloaded package with the file selector dialog.

  • Navigate to the “Meta Data” tab, and then click the “Deploy” button along the bottom of the UI.

    • This will open a new pop-up dialog titled “Deploying Metadata To Salesforce”

  • Click the “Deploy” button along the bottom of the dialog

  • This will open the “Deploy Log” tab of the dialog where logging messages of the deployment process will be displayed. When the deployment has finished successfully, a “DEPLOYMENT SUCCEEDED” message will appear:

    • If a failure message appears instead, please contact

After deploying the package, the Salesforce Job Logging Permission Set will need to be assigned to the Salesforce User provided to the CopyStorm application (specified on the “Main” tab of the CopyStorm application). The Permission Set was deployed as part of the deployment process above.

• Login to the Salesforce Org where the package was deployed, and assign the Permission Set to the appropriate user.

  • The Permission Set is called “CapStorm_CopyStorm_Job_Logging”

After the Permission Set has been assigned, CopyStorm will need to be configured to log job data to Salesforce.

• Ensure that you have the CopyStorm installed.

  • You will need version 10.54.2 or newer.

• Open CopyStorm, and navigate to the “Configuration” tab

• Change the “Configuration Level” dropdown value to “Advanced”, then navigate to the “Logging” section

Installing CopyStorm (Windows)

Installing CopyStorm takes a few seconds and does not touch any system files or registry values. You should not need an administrator.

• Make sure your computer meets the prerequisites.

  • All required software is packaged in the download as long as a Win32 or Win64 version of the application is selected.

• Download CopyStorm from https://www.capstorm.com/

• Create the directory “C:\Capstorm”

• Unzip the downloaded zip file into the “C:\Capstorm” directory. A single directory named CopyStorm will be created.

• Create the directory “C:\Capstorm\CopystormConfig”.

• Copy the CapstormCustomerKey.txt file into the “C:\Capstorm\CopystormConfig” folder.

  • Click for more information about the CapstormCustomerKey.txt file.

• Go to the “C:\Capstorm\CopyStorm” directory and:

  • Double click on CopyStorm.bat

Installing CopyStorm takes a few seconds and does not touch any system files. You should not need root permissions.

• Make sure your computer meets the prerequisites.

  • Java 11 (or above) must be installed.

• Download CopyStorm from

• Create the directory “/opt/capstorm”

CopyStorm can be installed in a Docker container by following instructions available here:

After creating the image and starting the container, it will run CopyStorm — backing up Salesforce to the configured relational database. When the backup finishes (successfully or with an error) the container will terminate.

• The API package must be enabled.

  • Enterprise, Unlimited, and Developer Editions have this feature enabled by default.

• A Salesforce login that can read data and data setup information.

CopyStorm is supported on:

• Windows

• Linux:

  • RHEL, SUSE, Ubuntu

• MacOS

CopyStorm requires a Java 11 JRE or higher. Downloads indicating Windows 32bit or 64bit include the Java JRE, other systems require that a JRE be installed.

Runtime requirements for the CopyStorm application can vary between installs – if the installation will only run one CopyStorm job at a time, a good starting point is:

• 1 CPU

• 2 GB RAM

• 10 GB of free disk space

  • CopyStorm stores large objects (e.g. Attachments) on-disk while copying to minimize RAM usage.