Self-hosting Tips and Tricks

Share your self-hosting setup and tips here.

Recommended Setup

• Small team (1-5 people): Single EC2 t4g.small or equivalent VPS. Run the omnibus Docker image with docker-compose. Total cost: ~$15/month.
• Medium team (5-20): Dedicated server with SSD. Use Litestream to back up to S3/MinIO. Add Caddy for SSL.
• Large team (20+): Consider the Fargate/Aurora deployment pattern. See the architecture docs.

Backup Strategy

Litestream continuously replicates your .fossil files to S3. Recovery is as simple as downloading the latest snapshot. Each .fossil file is self-contained -- no external dependencies needed to restore.

SSL with Caddy

The included Caddyfile handles automatic SSL via Let's Encrypt. Just point your domain and Caddy does the rest.

Docker Tips

• Use bind mounts for /data/repos so your repos survive container rebuilds
• Set FOSSIL_DATA_DIR to match your mount point
• The omnibus image includes sshd on port 2222 for SSH push/pull

Post your own tips below!