Delivr Documentation

Delivr is a next-generation, open-source email client for personal and professional team use. It's self-hostable, privacy-first, and works with any email server that speaks IMAP and SMTP.

These docs cover everything from deploying your own instance to scripting your mail through the API.

Start here

Self-host Delivr

Plan your deployment and get an instance running with Docker in minutes.

Use Delivr

Build with the API

Authenticate with API keys and automate your mail over REST.

Contribute

Set up a development environment and open your first pull request.

What is Delivr?

Delivr gives you a clean, fast, installable mail app while your mail stays on your own mail server. It's made of two parts:

Delivr API — a Bun + Hono backend that talks IMAP and SMTP to your mail servers, handles authentication, and exposes a documented REST API.
Delivr Web — a Nuxt 4 Progressive Web App that provides the interface on desktop and mobile.

Delivr API

Bun + Hono backend, IMAP/SMTP connectivity, OpenAPI docs, SQLite storage.

GitHub

Delivr Web

Nuxt 4 PWA with a generated type-safe API client and a dark-first, installable UI.

GitHub

Learn more in How Delivr Works.

Popular pages

Topic	Page
Run Delivr with Docker	Docker Compose
HTTPS with Caddy, Nginx, Traefik, or Apache	Reverse Proxy & HTTPS
Every environment variable	Configuration Reference
IMAP/SMTP settings for Gmail, iCloud, and more	Mail Provider Settings
Search operators like `from:` and `has:attachment`	Reading & Organizing
Something isn't working	Troubleshooting

Getting help

Check the FAQ and Troubleshooting.
Search or open an issue on GitHub.
Report security issues privately — see Responsible disclosure.