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 archivos adjuntos
240862 Accesos
Promedio (2 Votos)
La valoración media es de 3.0 estrellas de 5.
Comentarios
Respuestas anidadas Autor Fecha
I cannot access document_library via WebDAV... Thomas Ballerstedt 18 de julio de 2008 12:07
Just a note on Nautilus (GNOME) - when you... Sean C 9 de septiembre de 2008 12:50
In regards to the spaces, this has been fixed... Alexander Chow 30 de diciembre de 2008 15:05
Hi, It does not seem to work for us. We are... Aurbind Sharma 17 de abril de 2009 1:44
I would like to know if its possible to drag... Joffré Carrier 9 de junio de 2009 11:34
Is it possible to see who (what User) has... Markus Lindgren 25 de febrero de 2009 6:55
Windows VISTA native WebDav client is not... Reza Toghraee 25 de julio de 2009 4:07
Have you tried applying the patch from... Alexander Chow 20 de agosto de 2009 9:35
actually I did it today, but still the stupid... Reza Toghraee 7 de septiembre de 2009 13:52
could be that office 2007 is trying to save a... SZ khan 1 de septiembre de 2010 7:05
Does not work for non-admin user The WebDAV... Harshal Jawale 13 de febrero de 2010 17:18
I have a document libreray that is accessed by... Valentin Reynoso 17 de febrero de 2010 6:17
Testing it on LR 6.0.2 It seems to work great... Alex Wallace 16 de junio de 2010 15:15
Hi Alex, Yes, the things is on OS X (which I... Alexander Chow 14 de julio de 2010 6:48
Great article. Getting this to work can really... Nicolas GRUE 16 de septiembre de 2010 19:07
For WebLogic 10 and Basic Auth (used in portal... Igor Spasić 29 de septiembre de 2010 1:39
Hi, I'm having trouble mapping the network... Ashish Gupta 30 de septiembre de 2010 8:19
Can't seem to connect using the url.... Vishal Bhanderi 30 de noviembre de 2010 13:48
Try to download and install the patch available... Peter Goczan 18 de enero de 2011 1:44
Hi, I've just tested WebDAV on Wixdows 7 64-bit... Ales Rybak 18 de abril de 2011 11:33
In these properties, ... Kirk Stork 18 de mayo de 2011 17:24
Any update on class 2 compatibility? Could we... ger dupont 27 de septiembre de 2011 8:50
Class 2 is already supported by the Document... Alexander Chow 28 de septiembre de 2011 16:01
In Liferay 6.1 to enable Webdav is still... Denis Signoretto 16 de mayo de 2012 2:55
We removed the tunnel-web in 6.1. The WebDAV... Alexander Chow 12 de junio de 2012 3:40
Could someone please update this information?... John Parker 17 de julio de 2012 11:40
Yeah, I'm also having trouble finding the urls... Bernardo García Vila 21 de septiembre de 2012 3:29
Ramalingaiag i am In regards to the spaces,... Ramalingaiah Dudidmetle 18 de diciembre de 2014 22:53

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
Publicado el día 18/07/08 12:07.
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
Publicado el día 9/09/08 12:50.
In regards to the spaces, this has been fixed per http://issues.liferay.com/browse/LPS-1346. Thanks!
Publicado el día 30/12/08 15:05 en respuesta a Sean Condon.
Is it possible to see who (what User) has uploaded the document?
Publicado el día 25/02/09 6:55.
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
Publicado el día 17/04/09 1:44 en respuesta a Alexander Chow.
I would like to know if its possible to drag and drop files from your desktop to document library ?
Publicado el día 9/06/09 11:34 en respuesta a 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.
Publicado el día 25/07/09 4:07.
Have you tried applying the patch from http://www.microsoft.com/downloads/details.aspx?FamilyId=17C36612-632E-4C04-9382­-987622ED1D64&displaylang=en (per KB907306)?
Publicado el día 20/08/09 9:35 en respuesta a 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.
Publicado el día 7/09/09 13:52 en respuesta a 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.
Publicado el día 13/02/10 17:18.
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.
Publicado el día 17/02/10 6:17.
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!
Publicado el día 16/06/10 15:15 en respuesta a 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.
Publicado el día 14/07/10 6:48 en respuesta a 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.
Publicado el día 1/09/10 7:05 en respuesta a 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.
Publicado el día 16/09/10 19:07.
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.
Publicado el día 29/09/10 1:39.
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.
Publicado el día 30/09/10 8:19.
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
Publicado el día 30/11/10 13:48.
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
Publicado el día 18/01/11 1:44 en respuesta a 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?!? ;-)
Publicado el día 18/04/11 11:33.
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.
Publicado el día 18/05/11 17:24.
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.
Publicado el día 27/09/11 8:50 en respuesta a 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?
Publicado el día 28/09/11 16:01 en respuesta a g dupont.
In Liferay 6.1 to enable Webdav is still required tunnel-web ?
Publicado el día 16/05/12 2:55 en respuesta a Alexander Chow.
We removed the tunnel-web in 6.1. The WebDAV servlet is now specified in the main web.xml.
Publicado el día 12/06/12 3:40 en respuesta a 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
Publicado el día 17/07/12 11:40 en respuesta a 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.
Publicado el día 21/09/12 3:29 en respuesta a John Parker.
Ramalingaiag
i am
In regards to the spaces, this has been fixed per http://issues.liferay.com/browse/LPS-1346. Thanks!
Publicado el día 18/12/14 22:53.