Deployment

Weavestream is designed for self-hosted deployment using Docker Compose. This section covers everything you need to run it reliably in production.

Deployment Guides

• Docker Compose — production Docker Compose walkthrough
• TLS & Reverse Proxy — configure HTTPS with Nginx, Caddy, or Traefik
• Upgrades — how to update to a new version safely
• Backup & Restore — protecting your data

Architecture Summary

Internet → Reverse Proxy (Nginx/Caddy/Traefik) → web:3000 → api:4000
                                                            ↓
                                                       postgres / redis
                                                            │
                                              (api & worker share a
                                               host bind-mounted dir
                                               for uploaded files)

Weavestream does not terminate TLS itself. A reverse proxy handles HTTPS and forwards to the Next.js web container on port 3000.

Supported Platforms

All images are published as multi-arch (linux/amd64 + linux/arm64):

• Standard Linux servers (Debian, Ubuntu, Rocky, etc.)
• NAS appliances (Synology, UGREEN, TrueNAS) with Docker support
• Raspberry Pi 4/5 and other ARM boards
• Windows via Docker Desktop with WSL2
• macOS via Docker Desktop (development only)

Requirements