Skip to main content

Docker Compose

Reverse Proxy

Caddy

Nginx

CDN Subdomain

Map a CDN or subdomain to serve files directly:
Files at /{id} are public — no auth headers needed, making this ideal for CDN caching.

Production Checklist

  • Set SESSION_SECRET to a strong random value
  • Set ALLOWED_DOMAINS to restrict sign-in
  • Put Stashy behind TLS (reverse proxy or load balancer)
  • Set HOSTNAME to your public URL
  • Use local or gcs backend (not memory)
  • Mount a persistent volume for local storage
  • Back up your storage directory regularly
  • Use PostgreSQL for multi-instance setups
  • Back up SQLite file if using single-instance
  • Always run migrations on upgrade: stashy serve --migrate