Show Menu
TOPICS×

Troubleshoot AEM desktop app

Adobe Experience Manager (AEM) desktop app connects to a remote AEM deployment's Digital Asset Management (DAM) repository. The app fetches repository information and search results on your machine, downloads and uploads files and folders, and includes capabilities to manage conflicts with AEM Assets user interface.
Read on to troubleshoot the app, learn the best practices, and find out the limitations.

Best practices

Adhere to the following best practices to prevent some common issues and troubleshooting.
  • Understand how the desktop app works : Before starting to use the application, spend a few minutes knowing how the app works. Know about linking between Web UI and desktop, repository mapping, asset caching, saving locally and uploading in background. See how it works .
  • Avoid unsupported characters in folder names : Do not use whitespaces and invalid characters when creating or uploading folders. See a list of characters at Create folders in AEM Assets . Some AEM use cases may be impacted by unsupported characters in the folder name.
  • Best practices to avoid conflicts : To avoid potential conflicts when collaborating on multiple assets, see avoid editing conflicts .
  • Use folder upload for large, hierarchical folders : Instead of using the Assets web interface or other methods, use AEM desktop app to upload large folders. The app uploads the assets in background with logging and monitoring. See bulk upload assets .
  • Use the latest version : Use the latest app version and always check for compatibility before installing either a new app version or before upgrading to a newer AEM version. See release notes .
  • Use the same drive letter : Use the same drive letter across an organization to map to the AEM DAM. To see assets placed by other users, the paths must be the same. Using the same drive letter ensures a constant path to DAM assets. The assets remain placed and are not removed even if different drive letters are used by different users.
  • Mind the network : Network performance is critical to AEM desktop app's performance. If you face slowed response to file transfers or bulk operations, turn off the features or apps that might cause lots of network traffic.
  • Unsupported use cases for desktop app : Do not use the app for Assets' migration (it needs planning and other tools); for heavy-duty DAM operations (like moving large folders, large uploads, finding files using advanced metadata searches); and as a sync client (design principles and usage patterns are different from in-sync clients like Microsoft OneDrive or Adobe Creative Cloud desktop sync).

How to troubleshoot

To troubleshoot desktop app issues, be aware of the following information. Also, it prepares you to better convey the issues to Adobe Customer Care if you choose to seek support.

Enable debug mode

To troubleshoot, you can enable the debug mode and get more information in the logs. To run the app in debug mode, use the following command line options in a terminal or at the command prompt.
  • On Windows: SET AEM_DESKTOP_LOG_LEVEL=DEBUG & "C:\Program Files\Adobe\Adobe Experience Manager Desktop\Adobe Experience Manager Desktop.exe"
  • On Mac: AEM_DESKTOP_LOG_LEVEL=DEBUG open /Applications/Adobe\ Experience\ Manager\ Desktop.app

Location of log files

You can find the log files for AEM desktop app at the following locations. When uploading many assets, if some files fail to upload, see backend.log file at the above location to identify the failed uploads.
  • On Windows: %LocalAppData%\Adobe\AssetsCompanion\Logs
  • On Mac: ~/Library/Logs/Adobe\ Experience\ Manager\ Desktop
When working with Adobe Customer Care on a support request/ticket, you may be asked to share the log files to help the support team understand the issue. Archive the entire Logs folder and share it with the customer care.

Clear cache

Clearing AEM desktop app's cache is a preliminary troubleshooting task that can resolve several issues. Clear the cache from the app preferences. See set preferences . The default location of the cache folder is:
  • On Windows: %LocalAppData%\Adobe\AssetsCompanion\Cache\
  • On Mac: ~/Library/Group/Containers/group.com.adobe.aem.desktop/cache/
However, the location can change depending on AEM desktop's configured AEM endpoint. The value is an encoded version of the targeted URL. For example, if the application is targeting http://localhost:4502 , the directory name is http%3A%2F%2Flocalhost%3A4502%2F . To clear the cache, delete the appropriate folder. Another reason to clear cache is to free disk space when you are running low on disk space.
If you clear AEM desktop cache, local asset modifications that are not synced to AEM server, are irrevocably lost.

Know the AEM desktop app version

Click to open the app's menu and click Help > About .

Cannot see placed assets

If you cannot see the assets that you or other creative professionals placed in the support files (say, INDD files), check the following:
  • Connection to the server. Flaky network connectivity can stall asset downloads.
  • File size. Large assets take longer to download and display.
  • Drive letter consistency. If you or another collaborator placed the assets while mapping the AEM DAM to a different drive letter, the placed assets do not display.
  • Permissions. To check if you have permissions to fetch the placed assets, contact your AEM administrator.

Issues when upgrading on macOS

Occasionally issues may occur when upgrading AEM desktop app on macOS. This is caused by legacy system folder for AEM desktop app preventing new versions of AEM desktop app to load correctly. To remedy this issue, the following folders and files can be manually removed.
Before executing the following steps, drag the Adobe Experience Manager Desktop application from the macOS Applications folder to the Trash. Then open terminal, execute the following command, and provide your password when prompted.
sudo rm -rf ~/Library/Application\ Support/com.adobe.aem.desktop
sudo rm -rf ~/Library/Preferences/com.adobe.aem.desktop.plist
sudo rm -rf ~/Library/Logs/Adobe\ Experience\ Manager\ Desktop

sudo find /var/folders -type d -name "com.adobe.aem.desktop" | xargs rm -rf
sudo find /var/folders -type d -name "com.adobe.aem.desktop.finderintegration-plugin" | xargs rm -rf

Cannot upload files

If you are using desktop app with AEM 6.5.1 or later, upgrade S3 or Azure connector to version 1.10.4 or later. It resolves file upload failure issue related to OAK-8599 . See install instructions .

SSL configuration issue

The libraries that AEM desktop app uses for HTTP communication utilizes strict SSL enforcement. At times, a connection may succeed using a browser but fails using AEM desktop app. To configure SSL appropriately, install the missing intermediate certificate in Apache. See How to install an Intermediate CA cert in Apache .

App is unresponsive

Rarely the application may become unresponsive, display just a white screen, or display an error at the bottom of the interface without any options on the interface. Try the following in the order:
  1. Right click on the application interface and click Refresh .
  2. Exit the application and restart it.
In both methods, the app starts at the root DAM folder.