Install and configure AEM desktop app v1.x
Install and configure AEM desktop app to work with AEM Assets servers and download the assets to your local file system. To use AEM desktop app,
- Ensure that your AEM server version is supported by AEM desktop app. See the compatibility matrix .
- Download and install the application.
- Test the connection using a few assets. See Access and open assets on your desktop .
Install and connect AEM desktop app to AEM server
For details, see Install and connect AEM desktop app to AEM server .
Only one instance of the AEM desktop app can be installed and be active at a time.
AEM desktop app uses system's pre-defined proxy to connect to the Internet over HTTPS. The app can only connect using a network proxy that does not require extra authentication.
If you configure or modify proxy server settings for Windows (Internet Options > LAN Settings), restart the AEM desktop app for the changes to take effect.
If your proxy requires authentication, the IT team can whitelist the AEM Assets URL in the proxy server settings to allow the application traffic to pass through.
When changing a file from a network share location mounted by the desktop app, files are saved to that location in two phases. In the first phase, a file is saved locally. A user can save the file and continue working on the file, without waiting for the transfer to complete.
In the second phase, desktop app uploads the updated file to AEM server after a predefined delay (for example, 30s). This operation occurs in the background. Use the View Asset Status option to view the status of the upload operation.
- Upload an asset to AEM Assets.
- Click/tap the AEM desktop app icon from the toolbar.
- From the menu, select the View Asset Status option.
- From the dialog, review the status of the upload operation.
AEM desktop app can handle assets up to 40 GB.
Connect to an AEM instance behind a dispatcher
The copy and move methods in the Assets API require the following additional headers to be passed to AEM:
AEM Desktop connects to AEM using a URL that includes the default port. Therefore, the virtualhosts setting in the dispatcher configuration should include the default port number. For more information around virtualhosts configuration, see Identifying Virtual Hosts .
For additional information on configuring the dispatcher to pass through these additional headers, see Specifying the HTTP Headers .
Customize the Asset Info dialog
You can customize the Asset Info dialog by overlaying one or both of these components:
- The Granite user interface page at /libs/dam/gui/content/assets/moreinfo
On Windows, the cache is at %LOCALAPPDATA%\Adobe\AssetsCompanion\Cache\ , where is an encoded version of the AEM host configured in the desktop app. For example, http://localhost:4502 appears as http%3A%2F%2Flocalhost%3A4502%2F .
On Mac OS X, a similar directory is at ~/Library/Group Containers/group.com.adobe.aem.desktop/cache .
In-app option to manage cache
You can control the amount of disk space made available for local caching purposes. The artifacts from the AEM Assets server are cached locally for a smoother experience. You can change the defaults to suit your requirements. Also, you can clear the cache to fetch all assets afresh. To set the desired options, click the application's icon and click Advanced > Manage Cache . ****
When you clear the cache, it preserves your unsaved changes. Any assets not checked into AEM server are retained and not deleted.
Change location of cache on Windows
The default location of the cache for the AEM desktop app is:
- Windows: %LocalAppData%\Adobe\AssetsCompanion\Cache\EncodedAEMEndpoint
- Mac: ~/Library/Group/Containers/group.com.adobe.aem.desktop/cache/EncodedAEMEndpoint
EncodedAEMEndpoint is AEM desktop app's configured AEM endpoint URL. The value is an encoded version of the targeting URL of the AEM server. For example, if the application is targeting http://localhost:4502 , the directory name is http%3A%2F%2Flocalhost%3A4502 . The Windows path to the cache directory in this example is %LocalAppData%\Adobe\AssetsCompanion\Cache\http%3A%2F%2Flocalhost%3A4502.
To point the application to a different folder or a different drive, edit the application's configuration file.
- Navigate to the app’s installation directory. The default location on Windows is C:\Program Files (x86)\Adobe\Adobe Experience Manager Desktop .
- Edit Adobe Experience Manager Desktop.exe.config file with a text editor.Administrator privileges are required to save changes to this file.
- Search for the string "ProxyCacheRoot". You see that its value is set to the cache location "%LocalAppData%\Adobe\AssetsCompanion\Cache". Simply change this value to any valid path.The app automatically creates an <Encoded AEM Endpoint> subdirectory; this behavior is not configurable.