Get a Quote   (408) 943-4100               TrueNAS Discord      VendOp_Icon_15x15px   Commercial Support Toggle between Light and Dark mode

Configuring WebDAV Shares

  3 minute read.

Last Modified 2022-08-19 15:15 EDT

A Web-based Distributed Authoring and Versioning (WebDAV) share makes it easy to share a TrueNAS dataset and its contents over the web.

To create a new share, make sure a dataset is available with all the data for sharing.

Configuring a WebDAV Share

Go to Shares and click on Add on the WebDAV launch widget. The first WebDAV share added to your system opens the No WebDAV screen. Click Add WebDAV to open the Add WebDAV configuration screen.

AddWebDAVScreen

Enter a share Name.

Add the path to the pool or dataset in Path. Enter or use the arrow_right icon to the left of folder/mnt to browse to the dataset and populate the path. An optional Description helps to identify the share. To prevent user accounts from modifying the shared data, set Read Only.

To change existing ownership of all files in the share to the webdav user and group accounts leave Change User & Group Ownership selected. This default simplifies WebDAV share permission, but is unexpected, so the web interface displays a warning:

AddWebDAVWarningDialog

If you clear the Change User & Group Ownership checkbox this warning does not display and you must manually set shared file ownership to the webdav or www user and group accounts.

Click Save to add the share. The Enable service dialog opens. Click Enable Service to start the service or click Cancel to start the service at a later time.

Configuring WebDAV Service

To automatically start the service when TrueNAS boots, select Start Automatically.

Click to change the service settings.

ServicesWebDAVScreen

For better data security, set Protocol to HTTPS. If you require it, you must choose an SSL certificate (freenas_default is always available). Define a number in the Port field. But do not use the default 8080 or reuse the same port number. Make sure the network is not already using the WebDAV service port.

To prevent unauthorized access to the shared data, set HTTP Authentication to either Basic or Digest and create a new Webdav Password. Do not use the default password davtest as it is a known password.

TrueNAS requires a username and password when setting the Authentication WebDAV service option to Basic or Digest. Enter the user name webdav and the password defined in the WebDAV service.

Click Save after making changes.

Activating the WebDAV Service

Creating a share allows users to activate the WebDAV service.

You can enable the serivce from the Sharing screen Enable Service dialog or from the WebDAV launch widget toolbar option. Click more_vert and then click Turn On Service. Or you can go to System Settings > Services and scroll down to WebDAV and click the toggle to Start.

Connecting to the WebDAV Share

WebDAV shared data is accessible from a web browser. To see the shared data, open a new browser tab and enter {PROTOCOL}://{TRUENASIP}:{PORT}/{SHAREPATH} where the elements in curly brackets {} are variables to replace with your chosen WebDAV share and service settings. For example: https://10.2.1.1:8081/newdataset

Related Content