AnonAddy

Official

Overview

Self-hosted anonymous email forwarding

Requirements

Requires a separate MySQL and Redis server. See documentation: https://github.com/anonaddy/anonaddy/blob/master/SELF-HOSTING.md

Runtime arguments

Web UI: http://[IP]:[PORT:8000]/
Network: bridge
Privileged: false

Template configuration

Web UI PortPorttcp

Container Port: 8000

Target: 8000
Default: 8000
Value: 8000

SMTP Email PortPorttcp

Container Port: 25

Target: 25
Default: 25
Value: 25

App URLVariable

The URL to the AnonAddy server

Target: APP_URL
Default: http://localhost:8000/
Value: http://localhost:8000/

MySQL - HostVariable

The host for the MySQL database connection

Target: DB_HOST
Default: localhost
Value: localhost

MySQL - PortVariable

The port for the MySQL database connection

Target: DB_PORT
Default: 3306
Value: 3306

MySQL - UsernameVariable

The username for the MySQL database connection

Target: DB_USERNAME
Default: anonaddy
Value: anonaddy

MySQL - PasswordVariable

The password for the MySQL database connection

Target: DB_PASSWORD

MySQL - DatabaseVariable

The name of the MySQL database

Target: DB_DATABASE
Default: anonaddy
Value: anonaddy

Redis - HostVariable

The host for the Redis connection

Target: REDIS_HOST
Default: localhost
Value: localhost

Redis - PortVariable

The port for the Redis connection

Target: REDIS_PORT
Default: 6379
Value: 6379

Redis - PasswordVariable

The password for the Redis connection. Use 'null' to not set.

Target: REDIS_PASSWORD
Default: null
Value: null

Outgoing Mail - From NameVariable

The name to use when sending emails

Target: MAIL_FROM_NAME
Default: AnonAddy
Value: AnonAddy

Outgoing Mail - From AddressVariable

The email address to use when sending emails

Target: MAIL_FROM_ADDRESS

Outgoing Mail - HostVariable

The host for the mail server connection

Target: MAIL_HOST

Outgoing Mail - PortVariable

The port for the mail server connection. Not recommended to change.

Target: MAIL_PORT
Default: 25
Value: 25

Outgoing Mail - EncryptionVariable

The encryption for the mail server connection

Target: MAIL_ENCRYPTION
Default: tls
Value: tls

Outgoing Mail - EHLO HostVariable

The EHLO host for the mail server connection

Target: MAIL_EHLO_DOMAIN

Outgoing Mail - Verify PeerVariable

Verify the peer when connecting to the mail server

Target: MAIL_VERIFY_PEER
Default: true|false

AnonAddy - Return EmailVariable

The SMTP FROM address to be used if the alias address cannot be, e.g. for a custom domain that is not verified for sending

Target: ANONADDY_RETURN_PATH

AnonAddy - Admin UsernameVariable

The username for the admin account

Target: ANONADDY_ADMIN_USERNAME

AnonAddy - Enable RegistrationVariable

Allow users to register

Target: ANONADDY_ENABLE_REGISTRATION
Default: true|false

AnonAddy - DomainVariable

The domain to use for the AnonAddy server

Target: ANONADDY_DOMAIN

AnonAddy - HostnameVariable

The hostname to use for the AnonAddy server

Target: ANONADDY_HOSTNAME

AnonAddy - DNS ResolverVariable

The DNS resolver to use for the AnonAddy server

Target: ANONADDY_DNS_RESOLVER
Default: 127.0.0.1
Value: 127.0.0.1

AnonAddy - All DomainsVariable

Comma-separated list of all domains to use for the AnonAddy server

Target: ANONADDY_ALL_DOMAINS

AnonAddy - SecretVariable

The secret to use for the AnonAddy server. Run `openssl rand -base64 32` to generate.

Target: ANONADDY_SECRET

AnonAddy - Email LimitVariable

Number of emails that can be forwarded through the service per hour by any one user

Target: ANONADDY_LIMIT
Default: 200
Value: 200

AnonAddy - Bandwidth LimitVariable

Monthly bandwidth limit, in bytes

Target: ANONADDY_BANDWIDTH_LIMIT
Default: 104857600
Value: 104857600

AnonAddy - Alias LimitVariable

Number of new aliases that can be created per hour

Target: ANONADDY_NEW_ALIAS_LIMIT
Default: 100
Value: 100

AnonAddy - Additional Username LimitVariable

Number of additional usernames that can be added

Target: ANONADDY_ADDITIONAL_USERNAME_LIMIT
Default: 10
Value: 10

AnonAddy - Private Key FingerprintVariable

Fingerprint of the private key that you generated on the server to be used to sign encrypted forwarded emails

Target: ANONADDY_SIGNING_KEY_FINGERPRINT

Data DirectoryPathrw

Target: /data
Default: /mnt/user/appdata/anon_addy/data
Value: /mnt/user/appdata/anon_addy/data

App NameVariable

The name of the app

Target: APP_NAME
Default: AnonAddy
Value: AnonAddy

App EnvironmentVariable

The environment the app is running in

Target: APP_ENV
Default: production
Value: production

Enable DebuggingVariable

Enable debugging

Target: APP_DEBUG
Default: false|true

Log LevelVariable

The log level

Target: APP_LOG_LEVEL
Default: debug
Value: debug

DKIM Signing KeyVariable

Only needed if you plan to add any custom domains through the web application. See documentation: https://github.com/anonaddy/anonaddy/blob/master/SELF-HOSTING.md

Target: ANONADDY_DKIM_SIGNING_KEY

Log ChannelVariable

The log channel

Target: LOG_CHANNEL
Default: stack
Value: stack

Database ConnectionVariable

The database connection. Not recommended to change.

Target: DB_CONNECTION
Default: mysql
Value: mysql

Redis ClientVariable

The Redis client. Not recommended to change.

Target: REDIS_CLIENT
Default: phpredis
Value: phpredis

Mail DriverVariable

The mail driver. Not recommended to change.

Target: MAIL_DRIVER
Default: smtp
Value: smtp

DKIM SelectorVariable

The DKIM selector. Not recommended to change.

Target: ANONADDY_DKIM_SELECTOR
Default: default
Value: default

Links

Template Support Docker Hub Project

Details

Repository

anonaddy/anonaddy:latest

Registry

https://hub.docker.com/r/anonaddy/anonaddy

Last Updated2026-05-17

First Seen2024-09-30

Run AnonAddy on Unraid.

AnonAddy is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS