Skip to main content
📚 Documentation Hub

Master mailb0x operations with the docs the pros use

From bootstrapping a single workspace to orchestrating federated deliverability teams, this hub mirrors the experience operators get inside mailb0x.

🚀 Quick Start

Launch environments that mirror production from day one

Follow the same runbooks our deliverability desk uses. Each recipe includes commands, telemetry touchpoints, and teardown guidance for clean iteration.

Local development sandbox

Spin up the entire stack with per-user isolation. Includes dashboard, API, worker queue, and Flower monitoring.

Command
docker compose --env-file .env.dev up -d
Front-end http://localhost:3000, API http://localhost:8000
Inspect worker throughput via Flower on port 5555
Stop services safely with docker compose --env-file .env.dev down

Multi-tenant playground

Provision isolated customer workspaces with dedicated databases and service ports. Ideal for QA and shared staging.

Command
./provision-user.sh 001 up
Run from /root/sgpt/users to keep tenants encapsulated
Access tenant UI on port 3001 with mirrored API + Flower endpoints
Tear down with ./provision-user.sh 001 down when finished

Production deployment

Promote into hardened infrastructure with dedicated environment variables, migrations, and observability hooks.

Command
docker compose -f docker-compose.prod.yml --env-file .env.prod up -d
Copy .env.prod.example and inject secrets before launch
Run docker compose ... run --rm migrations after the stack is healthy
Monitor docker compose ... ps for service readiness and port exposure
🧭 Documentation Tracks

Choose the track that matches your role

Whether you own infrastructure, automation workflows, or compliance, each track curates the essential guides, reference docs, and playbooks.

Platform fundamentals

Workspace architecture, deliverability intelligence, and SMTP orchestration best practices.

Deliverability intelligence

Seed inbox telemetry, spam remediation, and engagement feedback loops.

Operational guardrails

Compliance surfaces, role-based permissions, and incident response workflows.

Automation toolkit

CLI utilities, worker automations, and API-first integrations.

📈 Release Notes

Track the modernization path of mailb0x

Every phase ships with measurable deliverability gains, automation upgrades, and operational guardrails. Scan the highlights or dive into the detailed guides.

Phase 7 — Federated operations

Expanded multi-tenant controls, sandbox seeding, and SOC2-ready audit trails.

May 2024
Dual-run database migrations with automated rollback checkpoints.
Scoped API tokens with rotation reminders and usage analytics.
Edge worker isolation for warm-up traffic and throttled campaign bursts.

Phase 6 — Automation lift

Workflow editor shipped with adaptive retry logic and deliverability triggers.

April 2024
Introduced JSON workflow DSL with CLI validation helpers.
Webhook pipeline gained idempotent retries and replay detection.
New monitoring widgets for spam score drift and inbox seed variance.

Phase 5 — Telemetry everywhere

Unified observability across SMTP, proxies, and inbox placements.

February 2024
Real-time inbox health cards with ISP-specific remediation tips.
Proxy pools surfaced latency histograms and automatic rotation policy.
Campaign timeline overlays for sentiment and engagement signals.

Need a guided architecture review?

Partner with our deliverability desk for migration planning, compliance guardrails, and automation audits tailored to your workspace footprint.