Self-Hosting
Quackback is designed to be self-hosted. Pick the deployment method that fits your setup.
Choose your path
| Method | Best for | Time |
|---|---|---|
| Railway | Fastest start, no server needed | 2 min |
| Docker | Most deployments | 10 min |
| Manual | Full control, no containers | 30 min |
If you're not sure, start with Docker. It handles dependencies, migrations, and updates automatically.
Before you start
Check the system requirements. You need PostgreSQL 14+ with pgvector, about 1 GB of RAM, and S3-compatible storage if you want file uploads. There is no Redis or other queue service to run: background jobs use PostgreSQL.
What's in this section
- Deploy with Docker: Docker Compose setup, configuration, upgrades
- Install without Docker: Bun, systemd, process management
- Upgrade from 0.13 to 0.14: Back up, upgrade, and what changes
- System Requirements: Hardware, software, cloud providers
- Reverse Proxy: Caddy, Nginx, Traefik configs for HTTPS
- Scale with multiple replicas: Split web and worker roles
- Declarative Configuration: Manage workspace settings as code
- Receive email over IMAP: Inbound email without a public webhook
- Troubleshooting: Common issues and solutions