IMAP & SMTP

Every mailbox speaks standard protocols. Apple Mail, Outlook, Thunderbird, phones — anything that can do IMAP and SMTP submission works out of the box.

Server settings

ProtocolServerPortSecurityAuth
IMAP (incoming)mx1.mail.atrix.dev993SSL/TLS (implicit)Normal password
SMTP (outgoing)mx1.mail.atrix.dev587STARTTLSNormal password
  • Username is the full address — hello@yourco.com, never just hello.
  • Password is the mailbox password. If you enable two-factor on your account, generate an app password per device under Mailbox → Security.
  • Both directions require authentication; there is no unauthenticated relay.

Client notes

  • Apple Mail (macOS / iOS): choose “Other Mail Account”, enter the address and password, then fill the servers above when automatic setup asks.
  • Outlook: pick IMAP, and set the SMTP encryption method explicitly to STARTTLS — Outlook defaults to SSL on 587, which fails.
  • Thunderbird: manual config; set both servers to mx1.mail.atrix.dev and authentication to “Normal password”.

Checking connectivity

shell
# IMAP: expect "* OK Atrix Mail ready"
openssl s_client -connect mx1.mail.atrix.dev:993 -quiet

# SMTP submission: expect "220 ... ESMTP"
openssl s_client -starttls smtp -connect mx1.mail.atrix.dev:587 -quiet

Behavior worth knowing

  • Folders map to IMAP as INBOX, Sent, Drafts, Archive, Junk, Trash; Iris labels appear as read-only keyword flags.
  • Mail sent over SMTP gets the same DKIM signing, logging, and webhook events as API mail, and counts against the same daily send limits.
  • IDLE (push) is supported; polling clients should poll no more often than once a minute.
Port 465 (implicit-TLS SMTP) and legacy IMAP on 143 are not offered — 993 and 587 are the supported pair.