agent-mail - Set up a LAN-only mail server for AI agents
Installs and configures maddy as a LAN-only multi-user mail server for local agents and mail clients on a Linux host.
Tags
Updated: 2026-10-16Capabilities
Typical Inputs
Typical Outputs
What this skill does
- Inspect target host
- Disable conflicting mail daemons
- Install maddy mail server
- Generate self-signed TLS certificates
- Render and install configuration
- Create mail accounts
- Verify service listeners
- Run mail smoke tests
Inputs
- SSH target host
- Mail domain
- Mail state directory
- Mail account names
- TLS mode
- Maddy configuration templates
Outputs
- Installed maddy service
- LAN mail service listeners
- Self-signed TLS certificate
- Configured mail server files
- Created mail accounts
- Generated passwords displayed once
- Service verification results
Requirements
- Linux Debian or Ubuntu host
- SSH access
- Passwordless sudo
- systemd
- curl, tar, and zstd
- aarch64 or x86_64 architecture
- Available mail ports
- Avahi for .local discovery