Show Menu
TOPICS×

Install Adobe Experience Manager desktop app

Using the Adobe Experience Manager desktop app, the assets within Experience Manager are easily available on your local desktop and can be used in any native desktop applications. Assets can be previewed, opened in native desktop applications, revealed in Mac Finder or Windows Explorer for placing in other documents, and changed locally – the changes are saved back to Experience Manager when you upload and a new version is created in the repository.
Such an integration allows various roles in the organization to,
  • Manage the assets centrally in Experience Manager Assets.
  • Access the assets in any native desktop applications, including third-party applications and in Adobe Creative Cloud. While doing so, users can easily adhere to the various standards including branding.
To use Experience Manager desktop app,

System requirements, prerequisites, and download links

For detailed information, see the Experience Manager desktop app release notes .

Upgrade from a previous version

If you are a user of v1.x of desktop app, then understand the differences and similarities between the previous and the latest version of the app. See what is new in desktop app and how the app works
Two version of desktop app cannot co-exist on a machine. Before you install a version, uninstall the other version.
To upgrade from a previous version of the app, follow these instructions:
  1. Before upgrading, sync all your assets and upload your changes to Experience Manager. This is to avoid losing any edits when uninstalling the app.
  2. Uninstall the previous version of the app. When uninstalling, select the option to clear the cache.
  3. Restart your machine.
  4. Download and install the latest app. Follow the instructions below.

Install

To install the desktop app, follow these steps. Uninstall any existing Adobe Experience Manager desktop app v1.x before installing the latest app. For more info, see above.
  1. Download the latest installer from the release notes page.
  2. Keep the URL and credentials of your Experience Manager deployment handy.
  3. If you are upgrading from another verison of the app, see upgrade desktop app .
  4. Skip this step if you are using Experience Manager as a Cloud Service, Experience Manager 6.4.4 or later, or Experience Manager 6.5.0 or later. Ensure that your Experience Manager setup meets the compatibility requirements mentioned in the release notes . If necessary, download the applicable compatibility package and install it using the Experience Manager Package Manager as an Experience Manager administrator. To install a package, see How to work with Packages .
  5. Execute the installer binary and follow the onscreen instructions to install.
  6. On Windows, the installer may prompt to install Visual Studio C++ Redistributable 2015 . Follow on-screen instructions to install it. If the installation fails then install it manually. Download the installer from here and install both vc_redist.x64.exe and vc_redist.x86.exe files. Re-run the AEM desktop app installer.
  7. Restart the machine as prompted. Launch and configure the desktop app.
  8. To connect the app with an AEM repository, click the app icon in the tray to launch the app. Provide the address of the AEM instance. Click Connect and provide the credentials.
    Figure: Connection screen to input server address
    Ensure there are no leading or trailing spaces before or after the address of the AEM server. Otherwise the app cannot connect to the AEM server.
  9. Upon successful connection, you can view the list of folders and assets available in the root folder of the AEM DAM. You can browse the folders from within the app.
    Figure: Application displays the DAM contents after login
  10. (Experience Manager 6.5.1 or later) If you are using desktop app with Experience Manager 6.5.1 or later, upgrade S3 or Azure connector to version 1.10.4 or later. See Azure connector or S3 connector .
    If you are an Adobe Managed Services (AMS) customer, contact Adobe Customer Care.

Set preferences

To change preferences, click and Preference . In the Preferences window, adjust the values of the following:
  • Launch application on login.
  • Show window when application starts.
  • Cache Directory : Location of local cache of the app (it contains the locally downloaded assets).
  • Network Drive Letter : The drive letter used to map to the AEM DAM. Do not change this if you are not sure. The app can map to any drive letter on Windows. If two users place assets from different drive letters, they cannot see the assets placed by each other. The path of the assets change. The assets remain placed in the binary file (say INDD) and are not removed. The app lists all the available drive letters and by default uses the last-available letter that is typically Z .
  • Maximum Cache Size : Allowed cache on hard disk in GB that is used toward storing locally downloaded assets.
  • Current cache size : Storage size of the locally downloaded assets. The information is displayed only after assets are downloaded using the app.
  • Automatically download linked assets : The assets that are placed in the supported native Creative Cloud apps are fetched automatically if you download the original file.
  • Maximum number of downloads : When downloading assets for the first time (via Reveal, Open, Edit, Download, or similar option), the assets are downloaded only if the batch contains less than this number. Default value is 50. Do not change if you are unsure. Increasing the value can lead to longer wait times and decreasing the value may not allow you to download the necessary assets or folders in one go.
  • Upload Acceleration : When uploading assets, the application can use concurrent uploads to improve upload speed. You can increase the concurrency of the upload by moving the slider to the right. The slider on the far left-hand side means no concurrency (single-threaded upload), the middle position corresponds to 10 concurrent threads, and the maximum limit on far right-hand side corresponds to 20 concurrent threads. A higher concurrency limit requires more resource consumption of the local machine's processor.
To update the unavailable preferences, log out of the AEM server. After updating the preferences, click to save the changes.
Figure: Desktop app preferences

Uninstall the app

To uninstall the application on Windows, follow these steps:
  1. Upload all your changes to AEM to avoid losing any edits. See Edit assets and upload updated assets to AEM . Log off and Exit the app.
  2. Remove the app as you’d remove any other OS application. Uninstall it from Add and remove programs on Windows.
  3. To remove the cache and logs, select the necessary check box.
  4. Follow the onscreen instructions. When completed, restart the machine.
To uninstall the application on Mac, follow these steps:
  1. Upload all your changes to AEM to avoid losing any edits. See Edit assets and upload updated assets to AEM . Log off and Exit the app.
  2. Remove the Adobe Experience Manager Desktop.app from /Applications .
Alternatively, to clean internal application caches on Mac and uninstall the app, you can execute the following command in the terminal:
/Applications/Adobe Experience Manager Desktop/Contents/Resources/uninstall-osx/uninstall.sh