Skip to content

QUICKSTART.md

Latest commit

 

History

History
38 lines (24 loc) · 1.39 KB

QUICKSTART.md

File metadata and controls

38 lines (24 loc) · 1.39 KB
Raw

Quick start

1. Prepare DNS

Create direct DNS records before installation:

  • A/AAAA for the public hostname
  • A/AAAA for the application hostname
  • A/AAAA for the mail hostname
  • MX for the mail domain pointing to the mail hostname

Do not proxy the mail hostname through an HTTP CDN. Confirm that inbound TCP ports 25, 80, and 443 reach the VPS.

2. Use a clean server

The automated installer targets Ubuntu Server 24.04 LTS. It deliberately refuses unsupported operating systems and an existing marked MailStack installation. Review any existing Postfix, Dovecot, MariaDB, or Nginx workload before using the installer.

3. Validate the plan

./install.sh --domain example.com --admin-email admin@example.com \
  --server-ip 203.0.113.10 --non-interactive --plan

4. Install

sudo ./install.sh --domain example.com --admin-email admin@example.com \
  --server-ip 203.0.113.10 --non-interactive

The initial administrator credential is written to a root-only file. Sign in, store the password in an approved password manager, change it immediately, then securely delete the file.

5. Verify external delivery

Send a message from an unrelated provider to postmaster@example.com. Confirm that Postfix accepts it, Dovecot writes it to Maildir, the ingestion service indexes it, and it appears in the application.

See docs/OPERATIONS.md for service and log commands.