> For the complete documentation index, see [llms.txt](https://docs.oboku.me/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.oboku.me/sync-providers/webdav.md).

# WebDAV

Oboku lets you use WebDAV server to synchronize your books but you need to make sure your WebDAV server is configured in a way that works.

## CORS

Your server needs to returns a valid CORS. You cannot use a wildcard `*` because oboku needs to sends credentials. This means you will have to specify the origin. If you use the cloud version, you can use <https://app.oboku.me>. If you use the self host version, use whatever host / ip you use.

## OPTIONS

Your browser will not sends the credentials for a preflight request (see <https://fetch.spec.whatwg.org/#http-cors-protocol>). This means your server must returns a valid HTTP status when responding to OPTIONS requests. This is a common issue with synology WebDAV server which requires authentication even for OPTIONS requests.

You can configure a reverse proxy in front of your WebDAV server and intercept OPTIONS requests to return a 200 status

## Sync behavior

When you sync you can prodive a directory as "root" or leave it empty for `/` path. This directory is from where the sync begins and therefore all sub folders will start being detected as collection.
