WebDAV

The Document Library and Journal portlets now provide support for the WebDAV protocol so users can upload and organize resources from both a web interface and the file explorer of their desktop operating system. Starting with Liferay Portal 5.0, Image Gallery will also be accessable via WebDAV.

What is WebDAV #

WebDAV provides functionality to create, change and move documents on a remote server (typically a web server or "web share"). WebDAV is supported by all major Operating Systems and Desktop Environments including Windows, MacOS X and Linux (KDE and GNOME).

For more information visit:

Determining the WebDAV URL #

Document Library - In the Document Library portlet, navigate to the specific folder and edit it (click the edit button to the right). In there you will see the direct WebDAV URL for that location.Image Gallery (v5.0+) - Pretty much the same as the Document Library. Journal - In the Journal portlet, navigate to the specific Journal Template and edit it. You should see the direct WebDAV URL for that template.

Login Credentials #

You can login using the login credentials you use to access the portal. In fact, you can use the email address, user ID or screen name -- all three will work.

In earlier versions of Liferay, you could only use your user ID. You can find your User ID by clicking My Account. It should be one of the first entries in the Profile tab that comes up. So if my User ID is 12345, then my login information would be:

 Login = 12345
 Password = ****

Note: Any time you change your password, emailaddress or screenname, you may need to re-login to the server via the portal. This includes when you first upgrade or use a clean installation of Liferay. Otherwise, when you login, you may see in your stacktrace something like the following: "User must first login through the portal 1234".

Configuring WebDAV support #

By default Liferay Portal allows WebDAV connections from any server using HTTP or HTTPS. It is possible to have a more secure configuration through the following properties of portal(-ext).properties:

 webdav.servlet.hosts.allowed=
 webdav.servlet.https.required=false

Note: this configuration is not currently available in 4.3.0

Accessing a WebDAV URL #

Each WebDAV accessible resource of Liferay has an associated URL. Copy that URL and use it to configure the file (or WebDAV) browser that you prefer. You will be asked to authenticate with your userId and password.

Following are specific instructions of how to configure access to the folder using WebDAV once you have the URL:

Windows #

Connecting to WebDav from Windows GUI may not always work as expected. It is recommended to use "net use" command from command line.

Mapping Network Drive (Vista or 7 only) #

  1. Right click on the Network icon and select Map Network Drive.
  2. Select a drive and enter the WebDAV URL and click Finish. Enter credentials when prompted.

Using "Add Network Places" Wizard (XP, Vista or 7) #

  1. On Vista or Windows 7, right click on the Computer icon and select Add Network Location. On XP and Server 2003, open My Network Places in Windows Explorer and double click Add a Network Place.
  2. Select "Choose another network connection" and click Next.
  3. Enter the WebDAV URL and click Next. Enter credentials when prompted.

Windows 98 #

  1. Using Windows Explorer go to the menu option "Web Folder...".
  2. Introduce the WebDAV URL and click enter.

Linux #

Konqueror (KDE) #

  1. Change the protocol of the URL so that instead of http://... it says webdav://...
  2. Write the URL in the location bar and click enter.

Nautilus (GNOME) #

  1. Change the protocol of the URL so that instead of http://... it says dav://... (davs://... when your site is using SSL).
  2. Write the URL in the location bar and click enter.

Mac OS X #

  1. In the Finder select the menu Go->Connect to Server.
  2. Type the address of the WebDAV server in the Server Address field and click "Connect". Enter credentials when prompted.

Known Issues #

General #

  • When viewing folders in the Document Library, files exist beginning with "._" (e.g., "._test.txt"). This is due to the implementation of OS X's WebDAVFS client. OS X creates a resource fork for every file it creates or modifies, storing it in a file that has a name prepended with "._". Though this is invisible on OS X, most other clients (including the Document Library portlet) display this file as present. Deleting this file will not cause any harm but will be regenerated when OS X finds the need to do so.
  • If you are using TortoiseSVN or TortoiseGIT, it will constantly query the WebDAV for .svn or .git folders. To skip the checks against these folders, add to your portal-ext.properties: webdav.ignore=.svn,.git
  • Setting GMT timezone on your application server may be critical! When user.timezone property is not set, application servers detect timezone from locale. During the communication with the WebDav client, all times will be sent in detected timezone (like CET). Some WebDav clients (like Windows7) don't handle timezones correctly, and expect the GMT.

Windows #

Problem Version of Windows MS KB Patch
MS Hotpatch required for WebDAV to work on various versions of Windows.XP, Vista, Server 2003 KB892211, http://support.microsoft.com/kb/907306KB907306]]Webfldrs-KB907306-ENU.exe
Error message of invalid folder when URL has a %20 in it. Replace all %20 strings with a single space " ".various KB888039
Getting "The folder name is not valid." error on Liferay 6.04 or below. This is due to the new requirement of Vista/7 for WebDAV to use Digest authentication. Workaround in KB notes.Vista, 7KB928692 LPS-10606
Move or copy of folders in Explorer returns an "Error 0x80070021: The process cannot access the file because another process has locked a portion of the file."Vista, 7LPS-12080
You experience a long delay when you try to access files on Liferay's WebDAV.Vista, Server 2003KB945435 Windows6.0-KB945435-x86.msu, http://www.microsoft.com/downloads/en/details.aspx?FamilyId=16A8648C-8213-453F-B0E6-5A539FD28C7A&displaylang=enWindows6.0-KB945435-x64.msu]]
You receive a folder copy error message when you try to download a file larger than 50MB. You may also get an error 0x800700DF. XP, VistaKB900900
On "Open in Office" link in IE, user is presented with the error message "Cannot open the requested document due to the following reason: Automation server can't create object."64-bit WindowsTechnet LibraryLPS-28718
7 Attachments
241129 Views
Average (2 Votes)
The average rating is 3.0 stars out of 5.
Comments
Threaded Replies Author Date
I cannot access document_library via WebDAV... Thomas Ballerstedt July 18, 2008 12:07 PM
Just a note on Nautilus (GNOME) - when you... Sean C September 9, 2008 12:50 PM
In regards to the spaces, this has been fixed... Alexander Chow December 30, 2008 3:05 PM
Hi, It does not seem to work for us. We are... Aurbind Sharma April 17, 2009 1:44 AM
I would like to know if its possible to drag... Joffré Carrier June 9, 2009 11:34 AM
Is it possible to see who (what User) has... Markus Lindgren February 25, 2009 6:55 AM
Windows VISTA native WebDav client is not... Reza Toghraee July 25, 2009 4:07 AM
Have you tried applying the patch from... Alexander Chow August 20, 2009 9:35 AM
actually I did it today, but still the stupid... Reza Toghraee September 7, 2009 1:52 PM
could be that office 2007 is trying to save a... SZ khan September 1, 2010 7:05 AM
Does not work for non-admin user The WebDAV... Harshal Jawale February 13, 2010 5:18 PM
I have a document libreray that is accessed by... Valentin Reynoso February 17, 2010 6:17 AM
Testing it on LR 6.0.2 It seems to work great... Alex Wallace June 16, 2010 3:15 PM
Hi Alex, Yes, the things is on OS X (which I... Alexander Chow July 14, 2010 6:48 AM
Great article. Getting this to work can really... Nicolas GRUE September 16, 2010 7:07 PM
For WebLogic 10 and Basic Auth (used in portal... Igor Spasić September 29, 2010 1:39 AM
Hi, I'm having trouble mapping the network... Ashish Gupta September 30, 2010 8:19 AM
Can't seem to connect using the url.... Vishal Bhanderi November 30, 2010 1:48 PM
Try to download and install the patch available... Peter Goczan January 18, 2011 1:44 AM
Hi, I've just tested WebDAV on Wixdows 7 64-bit... Ales Rybak April 18, 2011 11:33 AM
In these properties, ... Kirk Stork May 18, 2011 5:24 PM
Any update on class 2 compatibility? Could we... ger dupont September 27, 2011 8:50 AM
Class 2 is already supported by the Document... Alexander Chow September 28, 2011 4:01 PM
In Liferay 6.1 to enable Webdav is still... Denis Signoretto May 16, 2012 2:55 AM
We removed the tunnel-web in 6.1. The WebDAV... Alexander Chow June 12, 2012 3:40 AM
Could someone please update this information?... John Parker July 17, 2012 11:40 AM
Yeah, I'm also having trouble finding the urls... Bernardo García Vila September 21, 2012 3:29 AM
Ramalingaiag i am In regards to the spaces,... Ramalingaiah Dudidmetle December 18, 2014 10:53 PM

I cannot access document_library via WebDAV with IIS 6.0 using as frontend server.
Any hints to solve?

locally I can access via port 8080.

help welcome! regards Thomas
Posted on 7/18/08 12:07 PM.
Just a note on Nautilus (GNOME) - when you change the http:// to dav:// you must also add in the user name as an email address. This will look like
dav://test%40liferay.com@<server>/<folder>

You will then get prompted for the password in a pop up dialog.

I also found that where folder names had spaces, then there Nautilus had problems browsing through them (it recommended using another viewer)

Sean
Posted on 9/9/08 12:50 PM.
In regards to the spaces, this has been fixed per http://issues.liferay.com/browse/LPS-1346. Thanks!
Posted on 12/30/08 3:05 PM in reply to Sean Condon.
Is it possible to see who (what User) has uploaded the document?
Posted on 2/25/09 6:55 AM.
Hi,

It does not seem to work for us. We are getting the Windows error mentioned in this wiki (we have no %20 in URL). On the server, there is following exception:

14:09:13,846 ERROR [SharepointFilter:239] java.lang.NullPointerException
java.lang.NullPointerException
at com.liferay.portal.kernel.util.InstancePool._get(InstancePool.java:70)
at com.liferay.portal.kernel.util.InstancePool._get(InstancePool.java:66)
at com.liferay.portal.kernel.util.InstancePool.get(InstancePool.java:44)
at com.liferay.portal.sharepoint.SharepointUtil.getStorage(SharepointUtil.java:112)­
at com.liferay.portal.sharepoint.SharepointServlet.doPost(SharepointServlet.java:91­)
at javax.servlet.http.HttpServlet.service(HttpServlet.java:637)

Regards,
Aurbind
Posted on 4/17/09 1:44 AM in reply to Alexander Chow.
I would like to know if its possible to drag and drop files from your desktop to document library ?
Posted on 6/9/09 11:34 AM in reply to Aurbind Sharma.
Windows VISTA native WebDav client is not working with LifeRay. I used the webdrive client from http://www.webdrive.com/products/webdrive/index.htm it is working fine, but I still have some issues on saving file, and version control.
Posted on 7/25/09 4:07 AM.
Have you tried applying the patch from http://www.microsoft.com/downloads/details.aspx?FamilyId=17C36612-632E-4C04-9382­-987622ED1D64&displaylang=en (per KB907306)?
Posted on 8/20/09 9:35 AM in reply to Reza Toghraee.
actually I did it today, but still the stupid MS Vista does not understand and says the folder you entered does not appear to be valid.

my big problem is with Microsoft Office 2007. it is saving in .tmp files and makes liferay crazy. I put dl.file.extensions=* in portal.properties, its now better but I think people must work offline, and once they finished the edit, they must synchronize.
Posted on 9/7/09 1:52 PM in reply to Alexander Chow.
Does not work for non-admin user

The WebDAV works just fine for an admin role user but gives error for a community user,
01:12:29,287 ERROR [WebDAVServlet:111] com.liferay.portal.webdav.WebDAVException: com.liferay.portal.webdav.WebDAVException: com.liferay.portal.security.auth.PrincipalException
com.liferay.portal.webdav.Web­DAVException: com.liferay.portal.webdav.WebDAVException: com.liferay.portal.security.auth.PrincipalException
at com.liferay.portal.webdav.methods.PropfindMethodImpl.process(PropfindMethodImpl.­java:66)
at com.liferay.portal.webdav.WebDAVServlet.service(WebDAVServlet.java:108)
at javax.servlet.http.HttpServlet.service(HttpServlet.java:717)
at com.liferay.portal.kernel.servlet.PortalClassLoaderServlet.service(PortalClassLo­aderServlet.java:107)
at javax.servlet.http.HttpServlet.service(HttpServlet.java:717)

Not sure what is going wrong.
Posted on 2/13/10 5:18 PM.
I have a document libreray that is accessed by WebDav in Konqueror, everything OK, but when the users must close or save a file OpenOffice.org asks for user and password many many times (up to 20 times), and another day with same file or another one just works fine typing the user and password only once.
Anyone have an idea why is this happening ?
Thanks.
Posted on 2/17/10 6:17 AM.
Testing it on LR 6.0.2 It seems to work great to some extent:

DL: works for opening and adding docs... Replacing one kills the doc in LR (document not found when clicked)
Journal: Can see templates and strucutres, but not articles
IG: I can browse and see images, but I can't add images.

This was tested on a mac... Using omni admin account.

Thanks!
Posted on 6/16/10 3:15 PM in reply to Valentin Reynoso.
Hi Alex,

Yes, the things is on OS X (which I primarily use), it requires WebDAV Class Level 2 (locking) support to edit files. But that also means the OS can write all sorts of files that make no sense to the average user... including temp files.

As of right now, Journal and IG don't support files that are outside of their formats and, hence, does not allow locking (making it read-only on OS X). Journal articles are not supported for the simple reason that we don't know how to present this information to the end user (is it an XML file, a collection of files, images, or something else?).

As far as your DL issue.. are you saying when you edit a file, it kills the original document and creates a new one with the old name? This happens on Office -- it is mainly an implementation problem of Office and has nothing to do with Liferay.
Posted on 7/14/10 6:48 AM in reply to Alex Wallace.
could be that office 2007 is trying to save a backup copy/tmp everytime you push the save button. I used to get File access /write error in saving word documents in Win 7/Office 2007 and think now that these temp files were saved with domain account and not with portal one.
Posted on 9/1/10 7:05 AM in reply to Reza Toghraee.
Great article.
Getting this to work can really be a pain on Windows OS, so that table with KB / Patch in the end is really a good help.
Posted on 9/16/10 7:07 PM.
For WebLogic 10 and Basic Auth (used in portal 5.2), do not forget to add:

<enforce-valid-basic-auth-credentials>false</enforce-valid-basic-auth-creden­tials>

in config.xml, inside of <security-configuration> section.

This prevents Weblogic to authenticate users and pass the authentication to the portal.
Posted on 9/29/10 1:39 AM.
Hi,
I'm having trouble mapping the network place to document_library on Windows XP. The server is on Linux 2.6.5-7

I get the message "The folder you entered does not appear to be valid. Please choose another." on windows and notice in the tomcat log on the server, there are a couple of exceptions thrown as below.

10:58:15,376 ERROR [SharepointFilter:218] com.liferay.portal.security.auth.PrincipalException: User is null
com.liferay.portal.security.auth.PrincipalException: User is null
at com.liferay.portal.sharepoint.SharepointFilter.processFilter(SharepointFilter.ja­va:201)
at com.liferay.portal.kernel.servlet.BaseFilter.doFilter(BaseFilter.java:104)
at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilt­erChain.java:235)
at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.­java:206)
at com.liferay.portal.kernel.servlet.BaseFilter.processFilter(BaseFilter.java:177)
­at com.liferay.portal.servlet.filters.virtualhost.VirtualHostFilter.processFilter(V­irtualHostFilter.java:241)
.
.
.
10:58:36,524 ERROR [NtlmPostFilter:117] java.lang.NullPointerException
java.lang.NullPointerException
at com.liferay.portal.kernel.util.InstancePool._get(InstancePool.java:63)
at com.liferay.portal.kernel.util.InstancePool._get(InstancePool.java:59)
at com.liferay.portal.kernel.util.InstancePool.get(InstancePool.java:33)
at com.liferay.portal.sharepoint.SharepointUtil.getStorage(SharepointUtil.java:101)­
at com.liferay.portal.sharepoint.SharepointServlet.doPost(SharepointServlet.java:81­)
at javax.servlet.http.HttpServlet.service(HttpServlet.java:637)
at javax.servlet.http.HttpServlet.service(HttpServlet.java:717)
at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilt­erChain.java:290)
at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.­java:206)
.
.
.
10:58:36,759 ERROR [NtlmPostFilter:117] java.lang.NullPointerException
java.lang.NullPointerException
at com.liferay.portal.kernel.util.InstancePool._get(InstancePool.java:63)
at com.liferay.portal.kernel.util.InstancePool._get(InstancePool.java:59)
at com.liferay.portal.kernel.util.InstancePool.get(InstancePool.java:33)
at com.liferay.portal.sharepoint.SharepointUtil.getStorage(SharepointUtil.java:101)­
at com.liferay.portal.sharepoint.SharepointServlet.doPost(SharepointServlet.java:81­)
at javax.servlet.http.HttpServlet.service(HttpServlet.java:637)
at javax.servlet.http.HttpServlet.service(HttpServlet.java:717)
at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilt­erChain.java:290)
at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.­java:206)
.
.
.

Any help is much appreciated.

I've removed some of the stacktrace from the exception, pleasse let me know if more information is needed.
Posted on 9/30/10 8:19 AM.
Can't seem to connect using the url.
http://localhost:8080/tunnel-web/secure/webdav/guest/image_gallery/ImageGall­ery

I keep getting "The folder you entered does not appear to be valid. Please choose another"

The thing is the patches are for Vista and below. Im using Windows 7 Professional. Tomcat bundle (no IIS or Apache)

Any help is welcome!!

Thanks
Posted on 11/30/10 1:48 PM.
Try to download and install the patch available here:

http://www.microsoft.com/downloads/en/details.aspx?FamilyId=17C36612-632E-4­C04-9382-987622ED1D64&displaylang=en
Posted on 1/18/11 1:44 AM in reply to Vishal Bhanderi.
Hi, I've just tested WebDAV on Wixdows 7 64-bit and I was experiencing problems with long lugs and stalls when working with Document Library and Image Gallery. The solution for this was to disable automatic settings detection (go to the Internet Explorer > Tools (menu) > Internet Options > Connections (tab) > LAN Settings (button) > Automatically detect settings (checkbox) > uncheck. The lugs are gone now. B-) Hope this helps to anyone having same problems. Maybe this should be added into this article?!? ;-)
Posted on 4/18/11 11:33 AM.
In these properties,

webdav.servlet.hosts.allowed=
webdav.servlet.https.required=false

How would you specify a range of IPs that are allowed. For example, I want people who are logged in to our intranet via a VPN to have access, but nobody else.
Posted on 5/18/11 5:24 PM.
Any update on class 2 compatibility? Could we create directories (or webdav collections) in any ways outside the portlet. I mean using mounted folder on OS or directly with webdav client. So far I was unsuccessful on both approaches.
Posted on 9/27/11 8:50 AM in reply to Kirk Stork.
Class 2 is already supported by the Document Library. Other portlets do not support class 2 because of the functionality needed for them. You should have no problems creating folders via webdav.

What OS/Client are you using?
Posted on 9/28/11 4:01 PM in reply to g dupont.
In Liferay 6.1 to enable Webdav is still required tunnel-web ?
Posted on 5/16/12 2:55 AM in reply to Alexander Chow.
We removed the tunnel-web in 6.1. The WebDAV servlet is now specified in the main web.xml.
Posted on 6/12/12 3:40 AM in reply to Denis Signoretto.
Could someone please update this information? Item 2 in particular, Determining the WebDAV URL no longer applies, at least not for me. There is no WebDAV URL in the folder properties when I edit it under Liferay 6.1
Posted on 7/17/12 11:40 AM in reply to Alexander Chow.
Yeah, I'm also having trouble finding the urls and making the WebDav work under the 6.1 version. Any help would be appreciated.
Posted on 9/21/12 3:29 AM in reply to John Parker.
Ramalingaiag
i am
In regards to the spaces, this has been fixed per http://issues.liferay.com/browse/LPS-1346. Thanks!
Posted on 12/18/14 10:53 PM.