Channel Apps
[Markdown] 

WebDAV: connect_to_your_Hubzilla_streams_cloud

How to connect to your Hubzilla/streams cloud by WebDAV



Obtain the WebDAV URL in Hubzilla/streams:

Login in to your Hubzilla/stream Channel
go to settings

https://your.server.tld/settings

Copy the WebDAV URL.

https://your.server.tld/dav/[Channel-nikname]   
or sometimes
davs://your.server.tld/dav/[Channel-nikname]   


The address can be used in any WebDAV client to access the contents of all folders stored in the the HZ/Stream cloud.

Alternatively you can use the address https://your.server.tld/dav/[Channel-nikname]/[somefolder] or davs://your.server.tld/dav/[Channel-nikname]/[somefolder] to mount just a specific folders to your system.


Using WebDAV on Windows

Windows WebDAV Client

The Windows WebDAV client has known issues to be slow and working unstable. This problem won't get fixed by Microsoft so we advice you to use an alternative WebDAV client like CarrotDAV http://rei.to/carotdav_en.html to directly browse in your files.

Via Windows Explorer

- Open Windows Explorer (e.g. by right-clicking the Start button)
- Right-click Computer in the left navigation pane.
- Click on Map network drive...
- Select a free drive letter under the Drive drop-down.
- Enter the WebDAV URL of the folder into the Folder field.
- Check the Connect using different credentials checkbox.
- Enter your login and password to the cloud.

Via command line

- Open a Command Prompt window (or start cmd.exe).

- Use the net use command to mount your folder to a drive letter of your choice. Example:

- net use Z: https://your.server.tld/dav/[Channel-nikname] /user:USERNAME PASSWORD /persistent
Replace USERNAME and PASSWORD with your login to the Hubzilla/streams Account.
Replace https://your.server.tld/dav/[Channel-nikname] with the WebDAV URL for the folder you want to mount.

Troubleshooting WebDAV on Windows

  • (warning) Currently there are known bugs in Microsofts WebDav client:
    • The files that get uploaded via WebDAV are first stored at "%systemdrive%\windows\ServiceProfiles\LocalService\AppData\Local\Temp\TfsStore\" If the Systemdrive is full no upload is possible.
    • The WebDAV client has a bug that those files aren't deleted automatically after the upload was successfull. Windows Support Articel
    • When the connection to a server address fails the Microsofts WebDAV client won't try this connection again. You can solve this problem by restarting the service WebClient.
  • Currently there is a known problem with Word 2010. Word 2010 will crash if a file is opened from a WebDAV mount. As we can't solve that problem, you need to upgrade to a more recent version of Word (at least Word 2013).
  • Windows Server 2012 and above requires the Desktop Experience feature (S****erver Manager > Add Roles and Features > Features > User Interfaces and Infrastructure > Desktop Experience) to be installed, before WebDAV shares can be mounted locally. Furthermore you have to go to the Windows Services management, start the WebClient service and set it to Automatic, so it starts automatically in the future as well.
  • The built-in Windows client might crash occasionally. In that case it might help to restart the Windows service WebClient under Control Panel > Administrative Tools > Services. 
  • The built-in Windows client might be very slow. In that case please disable the automatic proxy detection in the Internet Explorer. You can find that setting in the Internet Explorer's Internet Options > Connections > LAN Settings > Automatically detect settings.
  • The built-in Windows client might repeatedly ask your for your credentials. In that case you might need to enable Basic Authentication:
Enable basic authentication for the Microsoft Windows Mini-Redirector component by modifying a key in the Windows registry
**Windows 7, Windows 8, Windows 10, Windows Server 2008 R2 Windows Server 2012 (R2), Windows Server 2016**
- 1. Click Start and type regedit in the Start Search box, and then click `regedit.exe` in the programs list.
- 2. Browse to the `HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WebClient\Parameters` key.
- 3. Find a DWORD/REG\_DWORD entry named `BasicAuthLevel`.
- 4. In the Value data box, type `2`, and then click OK.
- 5. Restart your computer


Using WebDAV on Mac OS X

Via menu

- Click on Go.
- Click on Connect to server...
- Enter the WebDAV URL of the folder into the Server Address field.
- Click on Connect.
- Choose Registered User and enter your login and password you are using to login to the cloud.
- Click on Connect.

Via command line

Mac OS X version 10.4 (Tiger) and following support WebDAV shares natively as a type of filesystem. The system can mount WebDAV-enabled server directories to the filesystem using the traditional BSD mounting mechanism.

The Finder presents a WebDAV share as an external disk, allowing users to interact with WebDAV just as they would with any other filesystem.


Using WebDAV on Linux

Linux users can mount WebDAV shares using davfs2 or fusedav which mount them as coda or FUSE filesystems. KDE has native WebDAV support as part of kio_http. This enables Konqueror and every other KDE application to interact directly with WebDAV servers.Nautilus also has WebDAV support built in. The cadaver command-line client, which provides an FTP-like command set, is included in many Linux distributions

Dolphin

To create a permanent WebDAV folder in Dolphin select Network in the remotes section of the places sidebar, then press the Add Network Folder button. The network folder wizard will appear. Select WebFolder (webdav), and fill in the subsequent form.

Alternately just click the path bar and then enter the url with webdav:// protocol specifier.

Nautilus

Install the gvfs and gvfs-dnssd packages.

In Nautilus choose "connect to server" and enter the address with dav:// or davs:// protocol specified:

dav://your.server.tld/dav/[Channel-nikname]

Note: If you get a "HTTP Error: Moved permanently" with dav://, try to use davs:// as the protocol instead.

rclone

rclone is a command line tool that lets you sync to/from, or mount (with many caching options), remote file systems including WebDAV.

Thunar

Install the gvfsand gvfs-dnssd packages.

In Thunar press Ctrl+l and enter the address with dav or davs protocol specified:

davs://your.server.tld/dav/[Channel-nikname]

In other file manager from GNOME, KDE and Xfce like pcmanfm-qt https://github.com/lxqt/pcmanfm-qt just add a bookmark with

davs://your.server.tld/dav/[Channel-nikname]

if you connect add the USERNAME and PASSWORD of your Hubzilla/streams account.


Install required software

Install davfs2 package to mount WebDAV resource as regular file system.

$ sudo apt-get install davfs2

Mount WebDAV share using command-line

Create the mountpoint directory.

$ sudo mkdir /home/name/webdav/

Use mount command to mount the WebDAV share.

$ sudo mount -t davfs -o noexec https://your.server.tld/dav/[Channel-nikname] /home/name/webdav/

Replace USERNAME and PASSWORD with your login to the Hubzilla/streams Account.
Replace https://your.server.tld/dav/[Channel-nikname] with the WebDAV URL for the folder you want to mount.