Synopsis
perch serve [OPTIONS]Description
serve runs in the foreground and starts the configured IMAP, IMAPS, submission, and SMTPS listeners plus the mxRaven WebSocket consumer and S3 reconciler.
It logs to stderr, drains connections on SIGTERM/SIGINT for up to five seconds, and reloads certificate files on SIGHUP when tls.cert_file and tls.key_file are set. It does not fork, write a PID file, or support socket activation.
Notes
- Use Type=simple in systemd; Type=notify and socket units are not supported.
- SIGHUP terminates the process when manual TLS files are not configured.
- Account, alias, and mailbox changes apply without restarting serve.
Options
| Option | Description |
|---|---|
--config <value> | configuration file (default: ~/.config/perch/perch.yaml) |
--help, -h | show help |
Examples
perch serve --config /etc/perch/perch.yaml
sudo systemctl reload perch # only with manual TLS files