Version française

Personal project — This software is provided as-is, without warranty. Make sure you understand how it works before using it in production. Test with non-critical data first. Use at your own risk.

Note: Unlike cloud sync clients that monitor file changes in real-time, webdav-sync performs scheduled synchronizations (via cron) or manual triggers. It's designed for periodic backups, not continuous bidirectional sync.

Lightweight Docker container for automatic WebDAV to local filesystem synchronization, with real-time web UI. Ideal for homelab, self-hosting and NAS backup. Works with kDrive, Nextcloud, ownCloud, Synology, QNAP, Seafile, pCloud, Box, Yandex Disk and any WebDAV server.

Any WebDAV-compatible server works with webdav-sync.

• Scheduled (cron) or manual synchronization
• Real-time web interface (progress, speed, ETA)
• Start / Pause / Resume / Stop controls
• Docker Secrets and Kubernetes support
• PUID/PGID management for NAS (Synology, Unraid, etc.)
• Rotating logs with web viewer

docker run -d \
  --name webdav-sync \
  -p 8080:8080 \
  -e REMOTE_URL=https://cloud.example.com/remote.php/dav/files/user/ \
  -e [email protected] \
  -e REMOTE_PASS=secret \
  -e CRON_SCHEDULE="0 5 * * *" \
  -v ./data:/webdav-sync/local-files \
  -v ./logs:/webdav-sync/logs \
  webdav-sync

Access the interface: http://localhost:8080

services:
  webdav-sync:
    build: .
    environment:
      - REMOTE_URL=https://123456.connect.kdrive.infomaniak.com/
      - [email protected]
      - REMOTE_PASS=secret
      - TZ=Europe/Paris
      - CRON_SCHEDULE=0 5 * * *
      - WEB_PASS=mysecret
    volumes:
      - ./data:/webdav-sync/local-files
      - ./logs:/webdav-sync/logs
    ports:
      - "8080:8080"

services:
  webdav-sync:
    build: .
    environment:
      - REMOTE_URL=https://nextcloud.example.com/remote.php/dav/files/username/
      - REMOTE_USER=username
      - REMOTE_PASS=app-password
      - TZ=Europe/Paris
      - CRON_SCHEDULE=0 */6 * * *
    volumes:
      - ./data:/webdav-sync/local-files
      - ./logs:/webdav-sync/logs
    ports:
      - "8080:8080"

services:
  webdav-sync:
    build: .
    environment:
      - REMOTE_URL=https://nas.local:5006/
      - REMOTE_USER=admin
      - REMOTE_PASS=secret
      - PUID=1000
      - PGID=1000
      - SYNC_OP=copy
    volumes:
      - ./data:/webdav-sync/local-files
      - ./logs:/webdav-sync/logs
    ports:
      - "8080:8080"

Sensitive variables can be passed via Docker Secrets:

services:
  webdav-sync:
    secrets:
      - remote_pass
    environment:
      - REMOTE_URL=https://cloud.example.com/
      - REMOTE_USER=user
      # REMOTE_PASS read from /run/secrets/remote_pass

secrets:
  remote_pass:
    file: ./secrets/remote_pass.txt

Resolution order:

1. /run/secrets/VAR (Docker Secrets)
2. VAR_FILE pointing to a file
3. Environment variable VAR

The interface accessible on port 8080 displays:

• Status: idle (orange), active (green), paused (blue), error (red)
• Progress: global bar + current transfers
• Storage: local and remote disk space
• Logs: viewer with date selector

The built-in authentication (HTTP Basic Auth) provides minimal protection. For production use or internet exposure, it is recommended to place webdav-sync behind a reverse proxy (Traefik, Caddy, nginx) with HTTPS.

• Base: Alpine Linux + rclone 1.71.2
• Web: BusyBox httpd + CGI
• Frontend: HTML5/CSS3/JS vanilla (no framework)
• Scheduling: crond
• ~1800 lines of code total

• Technical Documentation

MIT