> ## Documentation Index
> Fetch the complete documentation index at: https://snapr.seshuk.im/llms.txt
> Use this file to discover all available pages before exploring further.

# WebDAV

> Upload archives to a WebDAV server such as Nextcloud, OwnCloud, or Apache mod_dav.

`type: webdav` uploads archives to a WebDAV server — Nextcloud, OwnCloud, generic Apache `mod_dav`, and similar endpoints.

## Example

```yaml snapr.yaml theme={null}
storages:
  - type: webdav
    name: nextcloud
    url: https://cloud.example.com/remote.php/dav/files/backup
    username: backup
    password: env:DAV_PASSWORD
    path: snapr
```

## Options

| Option           | Type     | Required | Default | Description                                                                                                           |
| ---------------- | -------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------- |
| `type`           | `webdav` | Yes      | —       |                                                                                                                       |
| `name`           | string   | Yes      | —       | Identifier; unique within the job.                                                                                    |
| `url`            | string   | Yes      | —       | Base URL of the WebDAV endpoint.                                                                                      |
| `username`       | string   | No       | —       |                                                                                                                       |
| `password`       | string   | No       | —       | Use `env:`.                                                                                                           |
| `path`           | string   | No       | —       | Sub-path inside the endpoint.                                                                                         |
| `includeJobName` | bool     | No       | `true`  | Append the job name under `path`; see [Storages](/configuration/storages/overview#skipping-the-per-job-subdirectory). |

## Retention and layout

Archives are stored under `<url>/<path>/<job-name>/` (drop the job level with `includeJobName: false`). Retention deletes the oldest files in that directory once more than `retention.last` backup sets exist; see [Storages → Retention](/configuration/storages/overview#retention).

## Related

* [Storages overview](/configuration/storages/overview)