INSTALL GUIDE · COOLIFY / CAPROVER
Blue Folder Mail on Coolify / CapRover
Self-host PaaS: a dashboard that runs on your own VPS and gives you deploys, volumes and automatic TLS — the convenience of Render on a box you own.
Prerequisites
- Coolify or CapRover already installed on your VPS, with a wildcard/app domain configured.
- A subdomain to serve the app on (e.g. mail.example.com).
- A Resend account; an inbound provider for receiving.
Coolify
- New resource → from your Git repo Point Coolify at your fork; it builds the included Dockerfile. Set the exposed port to 8080.
- Add a persistent volume
Mount one at /data so the SQLite index and sealed blobs survive redeploys.
- Environment variables
Set RESEND_API_KEY, a random INBOUND_SECRET, and BASIC_AUTH_USER / BASIC_AUTH_PASS. Assign your domain — Coolify gets the TLS cert automatically. Deploy and create your mailbox.
CapRover
- Create an app Name it, then deploy from your repo (or caprover deploy). It builds the Dockerfile; set the container HTTP port to 8080.
- Add persistent data
In App Configs → Persistent Directories, map /data to a named volume.
- Env vars & HTTPS
Add RESEND_API_KEY, INBOUND_SECRET and the BASIC_AUTH_* pair. Enable HTTPS on the app's domain (one click, Let's Encrypt). Deploy.
Storage & sending
- Storage — the mounted volume at /data by default; or S3 for blobs via STORAGE_BACKEND=s3, keeping the SQLite index on the volume. Ciphertext only.
- Sending — verify your domains at resend.com and set RESEND_API_KEY.
Receiving mail — the honest part
Recommended — webhook
Point a provider (Mailgun, SendGrid, Postal, Resend inbound) at https://mail.example.com/_inbound with the secret as the x-inbound-secret header or ?secret=…, forwarding full raw MIME.