---
name: webdav
description: Configure, sync, backup, and restore VFS via WebDAV cloud storage.
tags: [webdav, cloud, backup, sync, storage, vfs]
category: system
---

## CRITICAL: VERIFY BEFORE EXECUTING
**ALWAYS run `help <command>` first.** If `help <command>` returns nothing, the command does NOT exist. Never invent commands — terminal crashes.

## 1. Configure & Status
- `webdav-config` — configure WebDAV endpoint URL and credentials
- `webdav-status` — verify connection health, last sync, space info

## 2. File Operations

| Command | Purpose |
|---------|---------|
| `webdav-ls [path]` | List remote directory contents |
| `webdav-push <local> <remote>` | Upload file to WebDAV |
| `webdav-pull <remote> [local]` | Download file from WebDAV |

## 3. Backup & Restore
- `webdav-backup` — push full VFS snapshot to WebDAV (`/backups/newos4-<date>.json`)
- `webdav-backup-list` — list all remote backup snapshots
- `webdav-restore <filename>` — restore VFS from remote backup

## 4. What Does NOT Exist
These will crash the terminal:
- `webdav-browser` ❌
- `webdav-explorer` ❌
- `webdav-delete` ❌
- `webdav-rm` ❌

Since `curl` is also blocked, no automated way to delete WebDAV backups from the terminal — use the WebDAV web interface outside.

## 5. When to Use
- Before factory-reset: `webdav-backup` to store VFS remotely
- Cross-browser: `webdav-push`/`webdav-pull` to move files
- User says "cloud backup" or "remote save"

## 6. Connection Details
- Uses per-user token stored in `.token` file on the server
- WebDAV runs on same server (nginx with WebDAV module) — no external dependency