selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Rapid Inbox logo

Self-host Rapid Inbox

v0.1.0

Self-hosted inbound email testing inbox

AlphaOpen SourceMIT
Updated2 months ago
LanguagePython
Setup difficultyAdvanced
Stars
128
Ports
8000 (HTTP admin console and API), 2525 (SMTP ingestion (container port))
Requires
SQLite
Install with Docker Compose
Rapid Inbox message details view showing email content and metadataRapid Inbox demo showing public inbox to message details flow

What is Rapid Inbox?

Rapid Inbox is a self-hosted inbound email system built for developers and test teams who need to receive and inspect emails locally without relying on external email services. It features a C++ SMTP ingestion engine that provides durable acknowledgments, byte-level backpressure, and multi-worker MIME parsing. Messages, attachments, and metadata are stored on the local filesystem and in SQLite. The system supports managed domains and catch-all modes, public and private inboxes, verification code extraction in multiple languages, role-based access control with three admin roles, and API keys with fine-grained scopes. Deployment options include Docker Compose as the primary method and native systemd on Debian/Ubuntu as a secondary option. The admin console provides a web UI for managing domains, mailboxes, and messages, while HTTP APIs (v1 and v2) enable programmatic access. The project is in alpha (0.x) with explicit non-goals including outbound SMTP, IMAP/POP3, multi-node HA, and advanced anti-spam.

Rapid Inbox alternatives

Should you self-host Rapid Inbox?

Rapid Inbox scores 42/100 on selfhost.directory (how scoring works) and ranks #84 of 106 in Email. It has 128 GitHub stars, -1 in the last 30 days.

It shipped 1 stable release in the past year. The latest, v0.1.0, came out on 16 August 2026.

Setup is advanced: plan for several services and some ongoing maintenance. It is MIT-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is Listmonk (80/100, 24 052 stars). It scores higher overall, so compare the two before you pick. See Rapid Inbox vs Listmonk side by side.

Features

  • Admin Console
  • C++ SMTP Ingestion Engine
  • Docker Compose Deployment
  • HTTP API v1 & v2
  • Live WebSocket Updates
  • Local Persistence & Recovery
  • Maintenance Tools
  • Managed Domains & Catch-All
  • Native systemd Deployment
  • Observability
  • Public & Private Inboxes
  • RBAC & API Keys
  • Retention & Cleanup
  • Sandboxed HTML Previews
  • Verification Code Detection

Rapid Inbox README

English | 简体中文

Rapid Inbox

A local-first, self-hosted temporary inbox for inbound email

C++ SMTP ingress, optional public inboxes, an admin console, and an HTTP API
Mail, attachments, metadata, and audit records are stored on local disk and in SQLite

Python C++ FastAPI SQLite License Status CI Release

Quick Start · Demo · Project Scope · Roadmap · Implemented Features · Configuration · Usage · Contributing · Security


Introduction

Rapid Inbox is built for open-source maintainers, developers, and test teams that need a self-hosted email testing environment for receiving verification codes, CI/E2E email capture, internal-tool integration, and lightweight self-hosting.

How to install Rapid Inbox

Install Rapid Inbox with Docker Compose

Environment variables
HTTP_PUBLISHED_ADDRESS, HTTP_PUBLISHED_PORT, SMTP_PUBLISHED_ADDRESS, SMTP_PUBLISHED_PORT, plus all application settings from .env.example

./docker-deploy.sh

Primary deployment method. Builds image, creates private config with random secrets, starts HTTP then SMTP with health checks.

How to configure Rapid Inbox

  • STORAGE_ROOTLocal source/development template. Copy this file to `.env` and edit the values you actually want to use. Docker and systemd deployments generate and manage separate private configuration files through their deployment scripts.
  • DATABASE_PATH./storage/app.db
  • BOOTSTRAP_ADMIN_USERNAMEadmin
  • BOOTSTRAP_ADMIN_PASSWORDLocal-dev bootstrap password used by the default launcher flow.
  • SESSION_COOKIE_NAMErapid_inbox_session

Rapid Inbox releases & version history

More in Email

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…