Documentation

Cleanmails Documentation

Cleanmails is a self-hosted cold email infrastructure platform. It combines email validation, multi-step campaign automation, sender rotation, mailbox warmup, AI personalization, and a full outreach CRM — all deployed on your own VPS with a single command. No monthly fees, no usage caps.

New to Cleanmails?

Start with the Quick Deploy guide to get up and running in under 10 minutes.

What You Get

✉️

Email Validation

SMTP handshake, 126k+ disposable blocklist, catch-all detection

🚀

Campaign Automation

Multi-step sequences, A/B testing, scheduling, AI tags

🔄

Sender Rotation

Unlimited mailboxes, health scoring, domain-aware assignment

🔥

Mailbox Warmup

30-day progressive warmup with auto-reply simulation

🤖

AI Copilot & MCP

Gemini-powered personalization, Claude/Cursor integration

🔗

Integrations

Webhooks, CRM sync (HubSpot, Salesforce, etc.), Slack

Quick Start

Deploy Cleanmails on any Ubuntu/Debian VPS with a single command:

bash

curl -sSL https://cleanmails.online/install.sh | bash -s -- --key YOUR_LICENSE_KEY --domain app.yourdomain.com

This installs Docker, pulls the Cleanmails image, configures Caddy for automatic SSL, sets up the integrated mail server, and starts everything. The whole process takes 2-5 minutes.

Requirements

Requirement	Minimum	Recommended
OS	Ubuntu 22.04 / Debian 12	Ubuntu 22.04 LTS
CPU	1 vCPU	4 vCPU
RAM	2 GB	8 GB
Storage	20 GB SSD	50 GB SSD
Port 25	Must be unblocked by VPS provider

Port 25 is critical

Most VPS providers block outbound port 25 by default. You must request it be unblocked before deploying. Without it, email validation and sending will not work.

Architecture Overview

Cleanmails runs as a single Docker Compose stack with three containers:

Cleanmails App — Go backend + React frontend (port 8080 internal)
Caddy — Reverse proxy with automatic Let's Encrypt SSL (ports 80/443)
docker-mailserver — Postfix + Dovecot for sending/receiving (ports 25/587/993)

All data is stored in a single SQLite database file (cleanmails.db) with WAL mode enabled for concurrent access. Backups are as simple as copying one file.

Support

Need help? Reach out via the support page or use the AI Copilot built into your dashboard for instant answers about your workspace.