hloolx/hloolmail

HLOOL Mail is a self-hosted email receiving platform that you run on your own server. Once running, you point any domain's mail records (MX records) at it, and the server accepts all incoming email for every address on that domain without requiring individual mailbox setup. It was built specifically for automated workflows: bulk account registrations, verification code collection during testing, CI pipelines, and AI assistants that need to read email programmatically. The project does not handle sending email and does not provide an IMAP or POP3 interface for use with regular mail clients like Outlook or Apple Mail. Its focus is on reliable receiving, inbox isolation between users or projects, and automation-friendly access. The entire codebase is written in Go, and the README is written primarily in Chinese. Access comes through three paths. A web console handles day-to-day management: creating mailboxes, managing domains, viewing incoming messages, and issuing API keys. An HTTP API lets scripts and AI tools create mailboxes, list messages, and read or delete emails using a key in the request header. Webhooks push incoming email events to your own systems as messages arrive, so you do not need to poll. A share link feature creates a public read-only URL for a specific mailbox so you can give someone else temporary viewing access without sharing credentials. Deployment is designed around Docker Compose. You configure a domain name, set a database password, and the container starts with a setup page on first run that walks through creating the admin account. PostgreSQL is the default database, though the README mentions SQLite works for local development. Pre-built binaries are also available for Linux, macOS, and Windows if you prefer running the server directly without Docker. The server supports wildcard domains, meaning a single running instance can receive mail for addresses like anything-at-all@subdomain.example.com if your DNS is configured accordingly. API documentation is served live from the running instance rather than a static site.