The Install Packages dialog installs and uninstalls Second-Generation Packages, both managed and unlocked, from your Dev Hub into a destination Salesforce org. You can queue several packages to install and several to uninstall in one run, enter installation keys for protected packages, and schedule the work for off-hours. Use Install Packages to put a new unlocked package in a sandbox for testing, to give a fresh scratch org a baseline set of packages, or to remove deprecated packages from production.
Video
The video walks through the whole flow: creating a package version from a Salesforce DX project with Create Packages, then installing that version with Install Packages.
Before you start
- Install the Salesforce DX command line interface on your computer.
- The source of the deployment arrow must be a Developer Project in Salesforce DX format, connected to the destination org. The packages themselves come from a Dev Hub.
- Create the packages and versions first, with the Create Packages dialog.
Opening Install Packages
Right-click the deployment arrow and choose Install Packages, or open the dialog from the Options Menu.
Select Install tab
- Choose the Dev Hub that holds the packages, and the destination org.
- Move the packages you want to install from Available Packages To Install to Selected Packages To Install. Select a package to see the package name, version number, namespace, and description.
- To install a package by hand instead, select the package and click Copy Install URL, or click Launch Install URL to open the installation page in a browser.
Select Uninstall tab
Choose the destination org, then move the packages to remove from Available Packages To Uninstall to Selected Packages To Uninstall.
Install Packages tab
- Review the Packages To Install and Packages To Uninstall. Packages are processed from top to bottom: the latest version of each selected package is installed, and the current version of each package to uninstall is removed.
- Packages shown in red are protected; enter the Installation Key for each one.
- Choose Wait For Completion to finish each package before starting the next, or Continue Immediately to move on as soon as each request is submitted.
- Click Install Packages.
A newly created package version can take a few minutes to become available. If Salesforce reports that the package is not available yet, wait a few minutes and click Install Packages again.
Schedule Install tab
When installs take a long time, schedule them for a later date and time, such as overnight.
Links
Break Your Salesforce Org Into Packages