WebDAV · Azalea

WebDAV is a file protocol on top of HTTP. After a photo leaves the phone it can land in a public cloud drive or on a NAS that has its WebDAV port open. The traffic is HTTP, not Samba’s TCP 445, so there is no presigned URL.

What to put in the profile

provider: webdav
endpoint: required absolute URL, for example https://dav.jianguoyun.com/dav/
bucket: optional folder appended to that path
access_key / secret_key: username / password. Both empty means anonymous. A password without a username is rejected
root: optional prefix inside the collection

The engine does not connect when the profile is saved. Test Connection lists one object. The first backup is the first upload. Originals do not pass through an Azalea server. Bundle net.duguying.photos.

Unlike Samba and object storage

If the house NAS is already on Samba, leave it there. That path has a counted lab run on Synology DSM 7. WebDAV is for services that only speak HTTP file access, or for the separate WebDAV port on DSM. Multiple profiles are supported: a cloud drive on the road, Samba at home.

There is no presign_put. Large files stream from the app with Content-Length. There is no probe(), so free space is not shown. A full volume errors on write.

Self-signed HTTPS is not trusted. For a Synology default certificate, use http:// and the port the control panel shows. iOS allows cleartext only to non-public addresses. Public drives should use the vendor’s own https:// URL.

Backups store an MD5 digest as a WebDAV custom property. A server that accepts PUT and rejects PROPPATCH fails the write. Run the read/write check in the app before an automatic backup.

Vendor URLs, app passwords, and products with no official WebDAV are in the guide. Those addresses come from each vendor’s public help, not from a full-library count on this site.