RMS Mail Mono

RMS Mail Mono — for those who need fast and proper self-hosted email without PostgreSQL, Redis, and half a day of setup. One user — one mailbox, strict isolation, minimal hardware requirements.

For whom

Mono is for you if you: run a VPS and want a proper webmail instead of Roundcube; develop and work in the browser all day; want AI and MCP integration with email without cloud services; hate spending time on infrastructure setup.

How it works

# 1. Clone the repository and navigate to the project directory
git clone https://github.com/max-ramas/rms-mail-public.git
cd rms-mail-public

# 2. Set up your environment variables
cp .env-m.example .env

# 3. Configure your `ENCRYPTION_KEYS` or `ENCRYPTION_KEY` and `JWT_SECRET` inside the .env file
# (You only need to enter the `ENCRYPTION_KEYS` or `ENCRYPTION_KEY` and `JWT_SECRET`; that is all the app needs to function)
# To generate a secure random 32-byte hex key, run: openssl rand -hex 32
# Also add ALLOWED_ORIGINS and FRONTEND_URL (your domain name)

# 4. Copy the Mono-specific compose configuration
cp docker-compose-m.yml docker-compose.yml

# 5. Fire it up!
docker compose up -d

# Images are pulled from Docker Hub: maxramas/rms-mail:m-latest + m-ui-latest

Open http://localhost:3000. Done.

For production — set up a reverse proxy on port 3000 (nginx, Caddy, aaPanel). Next.js proxies /api, /mcp, /internal to the Go backend itself.

What's inside

SQLite FTS5 — Full-text search without external indexers. Works on mailboxes with hundreds of thousands of emails.

LibSQL WAL — WAL mode and busy_timeout, safe concurrent writes without locks.

IMAP IDLE + watchdog — Push synchronization with automatic connection recovery. State is not lost.

Bidirectional flag synchronization — Mark as read in Apple Mail, it's also marked as read in RMS Mail. Works both ways.

Streaming IMAP ingestion — Loads emails in batches of 500 UID with O(1) memory consumption. Safe on folders with 200,000+ emails.

AI, Telegram, MCP — The same integrations as in Unified. Your own providers, your own keys.

Commands and hotkeys — Cmd+Shift+P for command palette, fully remappable shortcuts.

PWA — Installs as a native app on desktop and mobile.

Pricing

Community — Free, no feature limitations.

(Mono Pro with PostgreSQL + Redis on the roadmap — for those who need Mono isolation on enterprise infrastructure.)