Home

Welcome to the PolyPress Wiki

PolyPress is a premium, self-hosted, multitenant email newsletter management system. Designed to replace commercial newsletter tools, it offers strong data privacy, white-labeling capabilities, OIDC authorization, and flexible sending profiles (external SMTP relays or an internal direct-sending MTA).

---

📖 Table of Contents

• Installation & Setup — Run bootstrap installer, deploy via Docker/Portainer, first-run wizard.
• Architecture & Security — Multitenancy, global OIDC configurations, data storage, backups API.
• • Outbound Transports & MTA — Direct MTA (Direct Send), global fallback SMTP relay, and per-tenant thread limits.
• Bounce & Complaint Handling — Automatic IMAP mailbox processing and incoming webhooks configuration.
• Contacts Import & Preference Center — Custom schemas, multi-delimiter CSV imports, and preference center forms.
• Visual Email Designer — Building responsive templates, nested conditional display blocks, and A/B/C/D split testing.
• Marketing Automations — Visual automation flow builder with delay intervals and logical branches.
• Developer REST API & Webhooks — Syncing subscribers, direct sending, and webhook signature verification.

---

🛠️ High-Level System Architecture

graph TD
    UI[HTML5 + Alpine.js SPA] -->|API & Tracking| API[FastAPI Web Server]
    API --> DB[(SQLite Database)]
    Worker[Background Queue Worker] --> DB
    Worker -->|SMTP / Direct MTA| Internet[Recipients / External SMTP]
    IMAPWorker[IMAP Bounce Worker] -->|Poll Bounces| Mailbox[Bounce Mailbox]
    Mailbox --> IMAPWorker
    IMAPWorker --> DB

Loading