# Deploy AnonAddy with Easypanel

URL: /templates/anonaddy

AnonAddy (addy.io) is an open-source email alias and forwarding service that lets you create unlimited email aliases to protect your real address. This template runs the official all-in-one app image (web, queue worker, Postfix SMTP, and Rspamd bundled together) alongside MySQL and Redis.

## Installation notes

Receiving mail requires your domain's MX records to point at this server and port 25 to be reachable from the internet (many cloud providers block outbound/inbound 25 by default - check with yours first). After deploying, register the first account using the admin username you set below; it becomes the instance admin automatically. DKIM keys can be generated afterwards by running `anonaddy gen-dkim` inside the app container via Easypanel's terminal. By default outgoing mail (verification links, forwarded aliases, invites) is routed to a bundled Mailpit inbox so you can see what the app sends without any mail setup - open the Mailpit domain to view it and log in with the MP_UI_AUTH user and password from the Mailpit service's Environment tab. For real delivery to real inboxes, set an SMTP Relay Host below (and disable Mailpit if you no longer need it).

## Benefits

### Unlimited Aliases

Create as many email aliases as you need, on your own domain

### Reply & Send From Aliases

Reply to forwarded emails without revealing your real address

### Spam Filtering Built In

Bundled Rspamd filters incoming mail before forwarding

### Open Source

Free and open-source, full control over your email privacy

## Features

### Browser Extension

Generate aliases on the fly from Chrome, Firefox, and Safari

### PGP Encryption

Encrypt forwarded emails with recipient PGP keys

### Recipient Management

Forward different aliases to different inboxes

### Usage Limits & Bandwidth Controls

Per-user alias and bandwidth limits for multi-user instances

## Configuration

- `appServiceName` (App Service Name, required): anonaddy

- `appServiceImage` (App Service Image, required): anonaddy/anonaddy:1.7.2

- `domain` (Alias Domain, required): Set during installation — The domain aliases will be created under, e.g. example.com (its MX records must point here)

- `hostname` (Mail Server Hostname, required): Set during installation — The reverse-DNS hostname for outgoing mail, e.g. mail.example.com

- `adminUsername` (Admin Username, required): addy

- `enableMailpit` (Bundle Mailpit Test Inbox): true — Catches all outgoing mail in a web-viewable inbox instead of delivering it, so you can see verification/invite emails without any mail setup. Used automatically when no SMTP Relay Host is set below.

- `smtpRelayHost` (SMTP Relay Host (optional)): Set during installation — Postfix relayhost value for real outbound delivery, e.g. [smtp.mailgun.org]:587. Leave blank to use the bundled Mailpit inbox instead of delivering real mail.

- `smtpRelayUsername` (SMTP Relay Username (optional)): Set during installation

- `smtpRelayPassword` (SMTP Relay Password (optional)): Set during installation

## Services

- anonaddy: app (anonaddy/anonaddy:1.7.2)

- anonaddy-db: mysql

- anonaddy-redis: redis

- anonaddy-mailpit: app (axllent/mailpit:v1.20), optional

## Resources

- [Website](https://addy.io)

- [Documentation](https://github.com/anonaddy/docker)

- [GitHub](https://github.com/anonaddy/anonaddy)

- [Template source](https://github.com/easypanel-io/templates/tree/main/templates/anonaddy)