MailWizz Engineering Center · Version 3.8

MailWizz Engineering Guides

Practical guideUpdated July 2026By Ilirjan Trushilla2 min read
MailWizzv4.1 frameworkProduction reference

Practical guidance for installation, operations, scaling, security, and incident response.

Production Installation

A production-oriented MailWizz installation checklist covering prerequisites, filesystem ownership, TLS, cron readiness, and post-install validation.

Safe Upgrade Runbook

A rollback-aware MailWizz upgrade procedure with backups, maintenance windows, extension checks, migrations, and verification.

Delivery Server Architecture

How MailWizz delivery servers connect to PowerMTA, Postfix, APIs, and SMTP relays, with isolation and identity guidance.

Bounce Server Engineering

Configure and troubleshoot IMAP/POP3 bounce processing, mailbox sizing, cron cadence, and classification quality.

Feedback Loop Processing

Design complaint processing for major mailbox providers and ensure suppression actions are auditable.

Cron Jobs Explained

A practical map of MailWizz cron jobs, responsibilities, safe scheduling, overlap protection, and failure detection.

Queue Processing and Throughput

Understand campaign queue generation, sender execution, batching, concurrency, and bottleneck diagnosis.

Tracking Domain Design

Configure branded tracking domains with DNS, TLS, redirects, isolation, and validation.

Webhook Engineering

Build reliable MailWizz webhooks with authentication, retries, idempotency, logging, and failure recovery.

Suppression and Blacklist Management

Operate global and list-level suppression controls without accidentally reintroducing risky recipients.

Database Optimization

Indexes, slow-query review, table maintenance, retention, and safe cleanup for growing MailWizz databases.

Performance Tuning

Tune PHP, workers, cron cadence, database, filesystem, and relay capacity as one end-to-end system.

Security Hardening

Harden admin access, customer permissions, SMTP credentials, web server headers, uploads, and secrets.

Multi-server Deployments

Separate web, database, cron, tracking, bounce, and delivery roles while preserving observability.

PowerMTA Integration

Connect MailWizz to PowerMTA using scoped SMTP users, VMTA routing, bounce domains, and accounting logs.

Postfix Integration

Use Postfix as a MailWizz delivery transport with SASL, relay restrictions, DKIM, queues, and logging.

Domain Authentication

Align SPF, DKIM, DMARC, return-path, tracking, PTR, and HELO for MailWizz sending domains.

Campaign Settings

Choose send-at-once, pause, batch, tracking, reply-to, and segmentation settings safely.

Customer Quotas and Isolation

Create enforceable quotas and isolate customers by credentials, sending pools, domains, and reputation.

Bounce Classification

Interpret hard, soft, policy, reputation, and temporary failures and map them to appropriate actions.

Logging and Observability

Build dashboards and alerts for cron lag, queues, SMTP responses, bounce processing, and complaints.

Backup and Restore

Back up database, application files, uploads, extensions, and configuration with tested restore procedures.

Incident Response

Contain compromised accounts, bad campaigns, relay abuse, queue floods, and provider blocks methodically.

Cron Troubleshooting

Diagnose cron jobs that stop, overlap, run under the wrong PHP binary, or silently fail.

Delivery Troubleshooting

Trace a MailWizz message from campaign preparation through SMTP acceptance and provider response.

Bounce Troubleshooting

Resolve unprocessed mailboxes, authentication failures, duplicate bounces, and classification gaps.

Maintenance Calendar

A daily, weekly, monthly, and quarterly operating schedule for a dependable MailWizz installation.

Capacity Planning

Estimate database growth, queue volume, cron runtime, relay throughput, storage, and staffing headroom.

API Integration

Use MailWizz APIs with scoped credentials, validation, idempotency, rate limits, and audit logging.

Extension Governance

Evaluate, test, inventory, and safely update third-party MailWizz extensions and themes.

Search Trushilla Documentation