WebDAV Access

You are reading the CRX 2.3 version of WebDAV Access.
This documentation is also available for the following versions: CRX 2.2  CRX 2.1  CRX 2.0 (for CQ 5.3) 

CRX and CQ come with WebDAV support that lets you display and edit the repository content. Setting up WebDAV gives you direct access to the content repository through your desktop. Office and PDF files that are dropped into the repository through the WebDAV connection are automatically full-text indexed and can be searched with the standard search interfaces through the standard Java APIs.

Note

The instructions for using WebDAV for CRX and CQ are identical. The only difference is that CQ generally runs on port 4502 by default. Also see instructions for uploading digital assets

Connecting to WebDAV

Detailed Windows and MacOS instructions are included in this section, but essentially to connect to the default workspace of your repository using the WebDAV protocol, you point your WebDAV client to the following location:

http://localhost:7402/content/dam
        
file

CRX 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, CRX 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 as appropriate - CRX and CQ.

Note

In CRX, you can also find instructions for setting up WebDAV on Windows and MacOS by launching CRX and clicking Work with content from desktop on the CRX Launchpad.

WebDAV URLs

The URL for the WebDAV server has the following structure:

URL part http://<host>:<port> /<crx-webapp-path> /repository /<workspace>
Example http://localhost:7402 /crx /repository /crx.default
Description Host and port, on which CRX runs Path for the CRX repository webapp Path to which WebDAV servlet is mapped Name of the workspace mapped throught this path.
By changing the workspace element in the path, you can map workspaces other than the default one (crx.default); for example, to map a workspace named staging, use the following URL:
http://localhost:7402/crx/repository/<b>staging</b>
        

Additionally, when the CRX Launchpad module is installed and enabled, CRX provides an additional, simplified WebDAV URL to connect to:

http://localhost:7402/
        
This URL, when mounted 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.

Note

The simplified CRX Launchpad URL (for example, http://localhost:7402/) is mapped to the WebDAV server module from the CRX Launchpad application. While this module is served by the same underlying WebDAV server implementation as the one in CRX repository, it might be configured slightly differently (for example, with regard to how JCR nodes are mapped to files and folders while copying content from and to the repository). These differences should not impact the majority of use cases.

Setting up WebDAV for Windows

Note

If you are setting up WebDAV for Windows Vista, WebDAV requires Service Pack 2 and some modifications to the registry. See CRX WebDAV client technical requirements or CQ WebDAV client technical requirements for detailed instructions.

Note

Windows 2003 running SP2 requires manual configuration in order for WebDAV to function. See CRX WebDAV client technical requirements or CQ WebDAV client technical requirements for more information.

To set up WebDAV in a Windows environment:

  1. In My Computer, click My Network Places.

    file
  2. Click Add a Network Place to start the wizard.

  3. Select Choose another network location and click Next.

    file
  4. Type http://localhost:7402/crx/repository/crx.default and click Next.

    Note

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

    file
  5. Enter username admin and password admin. Initially, Day recommends that you use the pre-configured admin account for testing.

    file
  6. Enter a name for the connection and click Next.

    file
  7. Windows indicates that you have successfully added the network place. Open the network place to access your CRX repository.

    file

Setting up WebDAV for MacOS

To set up WebDAV with MacOS:

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

  2. In the Connect to Server window, type

    http://localhost:4502

    CRX prompts you for authentication.

    Note

    If CRX 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 DNS or IP address.

  3. Enter username admin and password admin. Initially, Day recommends that you use the pre-configured admin account for testing.

MacOSX has now mounted CRX as a volume and you can use it like any other drive.

Setting up WebDAV for Linux

To set up WebDAV with Linux (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, type http://localhost:7402/crx/repository/crx.default.

    Note

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

  4. In Folder, type /dav.

  5. Enter your username admin. Initially, Day 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. CRX prompts you for your password.

  8. Enter the password and click Connect. Linux GNOME has now mounted CRX as a volume and you can use it like any other drive.

To set up WebDAV with Linux (KDE):

  1. Open the Network Folder wizard.

  2. Select WebFolder (webdav) and click Next.

  3. In Name, type a connection name.

  4. In User, type admin. Initially, Day recommends that you use the pre-configured admin account.

  5. In Server, type http://localhost:7402/crx/repository/crx.default.

    Note

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

  6. In Folder, type dav.

  7. Click Save and Connect. CRX prompts you for your password.

  8. Enter the password and click Connect. Linux KDE has now mounted CRX as a volume and you can use it like any other drive.


Your comments are welcome!
Did you notice a way we could improve the documentation on this page?
Please leave your comments below and we will make the appropriate changes.

COMMENTS

  • By Jürg - 8:20 PM on Jan 25, 2011   Reply
    If you experience an "invalid hostname" error message on Vista or Win 7 while trying to establish a connection, you should do the registry patch as recommended under "Setting up WebDAV for Windows" on this page (http://dev.day.com/content/docs/en/crx/current/deploying/technical_requirements.html#WebDAV%20Clients)
    • By Gaston Gonzalez - 10:54 PM on Dec 28, 2011   Reply
      There is a light-weight command line utility called cadaver that runs under Unix. The following are simple instructions to get up and running with cadaver.

      1. Begin by downloading the source code for cadaver from http://www.webdav.org/cadaver/.

      2. Open a shell and unpack the tarball.

      $ tar -xzf cadaver-0.23.3.tar.gz
      $ cd cadaver-0.23.3
      $ ./configure && make
      $ su
      # make install

      3. For covenience, create a file called ~/.netrc and add the following to the file. This will allow you to run cadaver without entering credentials.

      machine localhost
      login admin
      passwd admin

      4. Execute cadaver with the CRX URI.

      $ cadaver http://localhost:4502/crx/repository/crx.default

      5. You should now be presented with a shell that looks as follows:

      dav:/crx/repository/crx.default/>

      6. Use should be able to interact with the CRX using simple shell commands (ls, cd, get, etc.). Simply type help in the shell for a list of commands or refer to the man page (man cadaver).

      I hope this helps.

      - Gaston Gonzalez
      • By Anonymous - 4:02 PM on Dec 30, 2011   Reply
        You can also run Cadaver under Windows with Cygwin. Here's a quick write-up: http://www.gastongonzalez.com/tech-blog/2011/12/30/cq5-webdav-support-for-windows-7-64-bit.html
        • By jbaix - 11:22 AM on Jan 17, 2012   Reply
          Thank you!
      • By Anonymous - 6:33 PM on Apr 15, 2012   Reply
        Hi,

        When you drog and drop file to CQ DAM using webdav. How the file will be created. what process will create the file. Does WEBDAV do anything or its just creating nt:file node in CRX.
        • By alvawb - 1:11 PM on Apr 24, 2012   Reply
          For more information, see http://sling.apache.org/site/repository-based-development.html#RepositoryBasedDevelopment-WebDAVSupport. If you have more detailed questions, feel free to post them at our dedicated user forum at http://forums.adobe.com/community/adep/ces/web-experience-management
        • By stevo - 12:19 PM on May 03, 2012   Reply
          On Windows 7 64bit i'am having the nice message:
          The Folder you entered does not apper to be valid

          ???
          • By aheimoz - 4:27 AM on May 04, 2012   Reply
            There might be various reasons for this, it is difficult to tell from the information given.

            We'd suggest that you post the details (exactly what you're trying to achieve, what you've done so far) to our dedicated CQ5 forum:
            http://forums.adobe.com/community/digital_marketing_suite/cq5
            Hope that helps.
            • By Anonymous - 4:57 AM on Sep 28, 2012   Reply
              http://www.windowsnetworking.com/kbase/WindowsTips/Windows7/AdminTips/Security/EnableBasicAuthforWebDAVonWindows7.html
            • By Chris - 10:52 PM on Oct 11, 2012   Reply
              Correct "setting up webdav on macos" instruction (2) to read http://localhost:7402/crx/repository/crx.default instead of http://localhost:7402/content/dam

              I'm seeing an inconsistency there.
              • By aheimoz - 3:42 AM on Oct 12, 2012   Reply
                Thanks for your feedback, we've updated that specific section.

                Further updates are also being on this page in other sections.
              • By Philip Jacobs - 7:39 PM on Jan 08, 2013   Reply
                Hi,
                Is there an easy way in CRX 2.3 to filter certain nodes (and their subnodes) so that they don't show up in the WebDav client? I noticed the filter uri setting, however I couldn't get it working. An example for be great.

                Many thanks
                • By X_X - 8:11 AM on May 07, 2013   Reply
                  I can access the page http://localhost:4502/crx/repository/crx with the browser but not with FileZilla. I tried with the protocols http, https, ftp and ftps. Any Idea?
                  • By Guillaume Carlino - 8:04 AM on May 17, 2013   Reply
                    Hi

                    For specific scenarios such as yours, please ask questions on the CQ5 forum: http://forums.adobe.com/community/digital_marketing_suite/cq5. You will reach a broader audience and receive a greater response.

                    Hope that helps,
                    Guillaume
                  • By Mahen - 8:50 AM on Sep 17, 2013   Reply
                    Nice article.
                    One input though..I could never access webdav at http://localhost:7402/content/dam or at http://localhost:4502/content/dam
                    or at http://localhost:7402/crx/repository/crx.default
                    The correct URL is http://localhost:4502/crx/repository/crx.default
                    The webdav has issues with Windows 8 wherein the /etc folders is inaccesible.
                    • By alvawb - 2:44 PM on Sep 17, 2013   Reply
                      Thank you for the feedback. We had an open issue around this. I've expedited the issue so that the information is updated soon.
                      • By C. - 3:45 PM on Oct 18, 2013   Reply
                        "The webdav has issues with Windows 8 wherein the /etc folders is inaccesible"

                        I have the same problem with Windows 7 (64 bit) - can't open, error message "incorrect parameter"
                        • By aheimoz - 10:29 AM on Oct 19, 2013   Reply
                          We would suggest that you contact the support team at Daycare (http://daycare.day.com).
                          Hope that helps.

                    ADD A COMMENT

                     

                    In order to post a comment, you need to sign-in.

                    Note: Customers with DayCare user accounts need to create a new account for use on day.com.

                    ***