.Dd September 26, 2026
.Dt MOX 1
.Os
.Sh NAME
.Nm mox
.Nd modern, secure, full-featured mail server
.Sh SYNOPSIS
.Nm
.Op Fl config Ar file
.Op Fl pedantic
.Ar command
.Op Ar arguments
.Sh DESCRIPTION
.Nm
is a modern, secure, full-featured, open source mail server for
low-maintenance self-hosted email.
It supports SMTP, IMAP, webmail, ACME (Let's Encrypt), and a built-in
webserver, all in a single binary with minimal configuration.
.Pp
The
.Sy serve
subcommand starts the server, accepting incoming email over SMTP,
serving it over IMAP, and providing web interfaces for administration,
account management, and webmail.
Many other subcommands manage a running instance, test email
functionality, or handle configuration.
.Pp
Commands that talk to a running instance communicate through a control
file in the data directory.
The configuration file holding the path to the data directory is
specified with the
.Fl config
flag or the
.Ev MOXCONF
environment variable.
.Pp
Run
.Nm
with no arguments to see the full list of subcommands and their usage.
Run
.Nm
.Ar help Ar command
for detailed help on a specific command.
.Sh COMMANDS
.Bl -tag -width Ds
.It Sy serve
Start mox, serving SMTP/IMAP/HTTPS.
.It Sy quickstart
Generate configuration files and print setup instructions.
.It Sy stop
Stop a running mox instance.
.It Sy localserve
Start a local SMTP/IMAP server for testing.
.It Sy sendmail
Drop-in replacement for
.Pa /usr/sbin/sendmail .
.It Sy config
Manage configuration files (test, describe, account, domain, alias, etc.).
.It Sy queue
Manage the message queue (list, hold, schedule, fail, drop, etc.).
.It Sy import
Import maildir or mbox into an account.
.It Sy export
Export mailboxes in maildir or mbox format.
.It Sy backup
Create a backup of the config and data directory.
.It Sy verifydata
Verify the contents of a data directory.
.It Sy dkim
DKIM key generation, lookup, sign, and verify.
.It Sy dmarc
DMARC lookup, verify, and report parsing.
.It Sy spf
SPF lookup, check, and parse.
.It Sy dns
DNS lookups (ptr, mx, txt, tlsa, etc.).
.It Sy dane
DANE dial and TLSA record generation.
.It Sy mtasts
MTA-STS policy lookup.
.It Sy tlsrpt
TLSRPT lookup and report parsing.
.It Sy version
Print the mox version.
.El
.Sh FILES
.Bl -tag -width Ds
.It Pa /etc/mox.conf
Static configuration file.
.It Pa /etc/domains.conf
Dynamic configuration file (domains and accounts).
.It Pa /etc/moxsubmit.conf
Configuration for
.Nm
when invoked as sendmail.
.El
.Sh ENVIRONMENT
.Bl -tag -width Ds
.It Ev MOXCONF
Path to the mox configuration file.
.El
.Sh SEE ALSO
.Xr sendmail 1
.Pp
.Lk https://www.xmox.nl/ "Mox website"
.Sh AUTHORS
Mechiel Lukkien.
.Sh LICENSE
Mox is dual-licensed under the MIT License and the Mozilla Public
License 2.0.

.