WebDAV Access

You are reading the AEM 6.2 version of WebDAV Access.
This documentation is also available for the following versions:  AEM 6.3  AEM 6.1  AEM 6.0  AEM 5.6.1  AEM 5.6  CQ 5.5 

To connect to AEM via WebDAV with KDE:

AEM offers WebDAV support that lets you display and edit repository content. Connecting via WebDAV gives you direct access to the content repository through your desktop. Text and PDF files that are added to the repository through the WebDAV connection are automatically full-text indexed and can be searched with the standard search interfaces and through the standard Java APIs.

General

Detailed instructions per operating system are included in this document, but the essentially to connect to your repository using the WebDAV protocol, you point your WebDAV client to the following location:

http://localhost:4502
        

Code samples are intended for illustration purposes only.

file

This URL, when connected from the operating system level, provides WebDAV access to the default workspace (crx.default). While being simpler for the user, it does not give them the additional flexibility of specifying workspace names, which can be accomplished using additional WebDAV URLs.

AEM displays the repository content as follows:  

  • A node of the type nt:folder is displayed as a folder. Nodes below the nt:folder node are displayed as the folder content.
  • A node of the type nt:file is displayed as a file. Nodes below the nt:file node are not displayed, but form the content of the file.

When you use WebDAV to create and edit folders and files, AEM creates and edits the necessary nt:folder and nt:file nodes. If you plan to use WebDAV to import and export content, try to work with nt:file and nt:folder node types as much as possible.

Note

Before setting up WebDAV, please check the Technical Requirements.

WebDAV URLs

The URL for the WebDAV server has the following structure:

URL Component http://<host>:<port> /<crx-webapp-path> /repository /<workspace>
Example http://localhost:4502 /crx /repository /crx.default
Description Host and port on which AEM runs Path for the AEM repository webapp Path to which WebDAV servlet is mapped Name of the workspace

By changing the workspace element in the path, you can map workspaces other than the default (crx.default). For example, to map a workspace named staging, use the following URL:

http://localhost:4502/crx/repository/staging
        

Code samples are intended for illustration purposes only.

Connecting via WebDAV

As mentioned above, to connect to your repository using the WebDAV protocol, you point your WebDAV client to your repository location. However depending on your OS, the steps involved to connect your client differ and there may be configuration of the OS required.

Instructions on how to connect the following opererating systems are provided:

Windows

To successfully connect a Microsoft Windows 7 (and greater) system to an AEM instance that is not secured with SSL, the option to establish basic authentication over an unsecured network must be explicitly enabled in Windows. This requires a change in the Windows Registry of the WebClient.

Once the registry is updated, then the AEM instance can be mapped as a drive.

Windows 7 and Greater Configuration

To update the registry to allow basic authentication over an unsecured network:

  1. Locate the following registry subkey:

    HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WebClient\Parameters
            

    Code samples are intended for illustration purposes only.

  2. Set the BasicAuthLevel registry entry subkey to a value of 2 or greater.

    If it is not present, add the subkey.

  3. You must restart the system for the registry change to take effect.

See Microsoft Support KB 841215 for more information on this registry change.

See Microsoft Support KB 2445570 for information about improving the responsivness of the WebDav Client under Windows.

Note

Adobe recommends that you create a Windows user with the same credentials as the repository user, otherwise you may encounter permission conflicts.

Windows 8 Configuration

For Windows 8 you also need to change the registry entry as described for Windows 7 and greater. However, before you can do this, the Desktop Experience must be enabled in order to see the registry entry.

To enable the Desktop Experience, open Server Manager, then Features, then Add Features, then Desktop Experience.

After rebooting the registry entry described for Windows 7 and greater is available. Modify it as described for Windows 7 and greater.

Connecting in Windows

To connect to AEM via WebDAV in a Windows environment:

  1. Open Windows Explorer or File Explorer and click on Computer or This PC.

    file
  2. Click Map network drive to start the wizard.

  3. Enter the mapping details:

    • Drive: Choose any available letter
    • Folder: http://localhost:4502
    • Check Connect using different credentials

    Click Finish

    file

    Note

    If AEM is located on another port, use that port number instead of 4502. Also, if you are not running the content repository on your local machine, replace localhost with the respective server name or IP address.

  4. Enter username admin and password admin. Adobe recommends that you use the pre-configured admin account for testing.

    file
  5. The wizard closes and the newly-mapped drive is opened in a Windows Explorer or File Explorer window.

    file

Windows has now mapped AEM as a drive via WebDAV and you can use it as any other drive.

macOS

There are no configuration steps required to connect via WebDAV on macOS. You simply need to connect to the WebDAV server.

  1. Navigate to any Finder window and click Go and Connect to Server, or press Command+k.

  2. In the Connect to Server window, enter the AEM location:

    • http://localhost:4502

    Note

    If AEM is located on another port, use that port number instead of 4502. Also, if you are not running the content repository on your local machine, replace localhost with the respective server name or IP address.

  3. When you are prompted for authentication, enter username admin and password admin. Adobe recommends that you use the pre-configured admin account for testing.

macOS has now connected to AEM via WebDAV and you can use it as any other folder on your Mac.

Linux

Connecting via WebDAV on Linux doesn't require any configuration, but does involve a few steps to make the connection which vary depending on your desktop environment.

GNOME

To connect to AEM via WebDAV with GNOME:

  1. In Nautilus (file explorer), select Places and select Connect to Server.

  2. In the Connect to Server window, select WebDAV (HTTP) in Service Type.

  3. In Server, enter http://localhost:4502/crx/repository/crx.default

    Note

    If AEM is located on another port, use that port number instead of 4502. Also, if you are not running the content repository on your local machine, replace localhost with the respective server name or IP address.

  4. In Folder, enter /dav

  5. Enter the username admin. Adobe recommends that you use the pre-configured admin account for testing.

  6. Leave the port blank and enter any name for your connection.

  7. Click Connect. AEM prompts you for your password.

  8. Enter the password admin and click Connect.

GNOME has now mounted AEM as a volume and you can use it like any other volume.

KDE

  1. Open the Network Folder wizard.

  2. Select WebFolder (webdav) and click Next.

  3. In Name, type a connection name.

  4. In User, enter admin. Adobe recommends that you use the pre-configured admin account.

  5. In Server, enter http://localhost:4502/crx/repository/crx.default

    Note

    If AEM is located on another port, use that port number instead of 4502. Also, if you are not running the content repository on your local machine, replace localhost with the respective server name or IP address

  6. In Folder, enter dav

  7. Click Save and Connect.

  8. When prompted for your password, enter the password admin and click Connect.

KDE has now mounted AEM as a volume and you can use it like any other volume.

Any questions?

Have a question about this or any other AEM topic? Ask our Community.
Learn more about AEM topics on our help hub.
Was this helpful?

By submitting your feedback, you accept the Adobe Terms of Use.

Thank you for submitting your feedback.