Back to blog
getting-starteddeploymentself-hosted

Getting Started with Mailingo

Mailingo Team·

Mailingo is a self-hosted mail server appliance that pairs a reliable Postfix, Dovecot, and Rspamd mail stack with a polished admin control plane and a focused webmail client.

This guide walks you through deploying Mailingo and setting up your first domain.

Prerequisites

Before you begin, you will need:

  • A server with Docker and Docker Compose installed
  • A domain name with DNS access
  • Port 25 open for SMTP delivery

Deploying Mailingo

Mailingo ships as a Docker Compose appliance. Clone the repository and start the stack:

docker compose up -d

The stack includes Postfix, Dovecot, Rspamd, PostgreSQL, the Admin API and UI, and the Mailbox API and UI.

Setting Up Your First Domain

Open the Admin UI and add your domain. Mailingo will generate the DNS records you need:

  • MX record pointing to your server
  • SPF record authorizing your server
  • DKIM record for mail signing
  • DMARC record for policy enforcement

The DNS diagnostics page will show you exactly which records are missing or incorrect, with the current value, expected value, and remediation steps.

Creating Mailboxes

Once your domain is configured, create mailboxes for your users. Set quotas, manage aliases, and monitor usage from the admin dashboard.

Users can then log into the Mailbox UI to read, send, and manage their email from any browser.

What Next?

  • Configure spam filtering policies in the admin UI
  • Set up Prometheus monitoring with the built-in metrics endpoint
  • Explore the telemetry dashboard for live operational metrics
  • Check back for backup and restore guides