AnonAddy Install Guide
Here is a working compose stack based on official docker image and AnonAddy self-hosting guide.
Docker
Be sure to touch acme.json and chmod 0600 acme.json before starting the stack.
version: "3.5"
services:
traefik:
image: traefik:2.7
container_name: traefik
command:
- "--global.checknewversion=false"
- "--global.sendanonymoususage=false"
- "--log=true"
- "--log.level=INFO"
- "--entrypoints.http=true"
- "--entrypoints.http.address=:80"
- "--entrypoints.http.http.redirections.entrypoint.to=https"
- "--entrypoints.http.http.redirections.entrypoint.scheme=https"
- "--entrypoints.https=true"
- "--entrypoints.https.address=:443"
- "--certificatesresolvers.letsencrypt"
- "--certificatesresolvers.letsencrypt.acme.storage=acme.json"
- "--certificatesresolvers.letsencrypt.acme.email=webmaster@postx.me"
- "--certificatesresolvers.letsencrypt.acme.httpchallenge"
- "--certificatesresolvers.letsencrypt.acme.httpchallenge.entrypoint=http"
- "--providers.docker"
- "--providers.docker.watch=true"
- "--providers.docker.exposedbydefault=false"
ports:
- target: 80
published: 80
protocol: tcp
- target: 443
published: 443
protocol: tcp
volumes:
- "./acme.json:/acme.json"
- "/var/run/docker.sock:/var/run/docker.sock"
restart: always
db:
image: mariadb:10.5
container_name: anonaddy_db
command:
- "mysqld"
- "--character-set-server=utf8mb4"
- "--collation-server=utf8mb4_unicode_ci"
volumes:
- "./db:/var/lib/mysql"
environment:
- "MYSQL_ALLOW_EMPTY_PASSWORD=yes"
- "MYSQL_DATABASE"
- "MYSQL_USER"
- "MYSQL_PASSWORD"
restart: always
redis:
image: redis:4.0-alpine
container_name: anonaddy_redis
restart: always
anonaddy:
image: anonaddy/anonaddy:latest
container_name: anonaddy
depends_on:
- db
- redis
ports:
- target: 25
published: 25
protocol: tcp
volumes:
- "./data:/data"
labels:
- "traefik.enable=true"
- "traefik.http.routers.anonaddy.entrypoints=https"
- "traefik.http.routers.anonaddy.rule=Host(`app.postx.me`)"
- "traefik.http.routers.anonaddy.tls=true"
- "traefik.http.routers.anonaddy.tls.certresolver=letsencrypt"
- "traefik.http.routers.anonaddy.tls.domains[0].main=postx.me"
- "traefik.http.routers.anonaddy.tls.domains[0].sans=mail.postx.me,app.postx.me"
- "traefik.http.services.anonaddy.loadbalancer.server.port=8000"
env_file:
- "./anonaddy.env"
environment:
- "DB_HOST=db"
- "DB_DATABASE=${MYSQL_DATABASE}"
- "DB_USERNAME=${MYSQL_USER}"
- "DB_PASSWORD=${MYSQL_PASSWORD}"
- "REDIS_HOST=redis"
restart: always
Environment Variables
.env:
MYSQL_DATABASE=anonaddydb
MYSQL_USER=anonaddy
MYSQL_PASSWORD=p8gjR7buSCoQNCL6djooiAEAPQd3oRMf
anonaddy.env:
TZ=Edmonton/America
PUID=1000
PGID=1000
MEMORY_LIMIT=256M
UPLOAD_MAX_SIZE=96M
OPCACHE_MEM_SIZE=128
REAL_IP_FROM=0.0.0.0/32
REAL_IP_HEADER=X-Forwarded-For
LOG_IP_VAR=remote_addr
APP_NAME=AnonAddy
APP_ENV=production
APP_KEY=base64:2UpNRn68cBnMFqCUmVp5P4YUw+hBgJG0ZKYT6IgC108=
APP_DEBUG=false
APP_URL=https://app.postx.me
ANONADDY_RETURN_PATH=bounces@postx.me
ANONADDY_ADMIN_USERNAME=anonaddy
ANONADDY_ENABLE_REGISTRATION=false
ANONADDY_DOMAIN=postx.me
ANONADDY_ALL_DOMAINS=postx.me,sendly.cc,postbin.me,privatesend.me,mailhop.me
ANONADDY_HOSTNAME=mail.postx.me
ANONADDY_DNS_RESOLVER=127.0.0.1
ANONADDY_SECRET=j9GShsAnMGr89fGvHUHfRtDgTEDECJnbudJXY4bjnuT9eRLjKZu8msDQt9zX2y9m
ANONADDY_LIMIT=500
ANONADDY_BANDWIDTH_LIMIT=10485760000
ANONADDY_NEW_ALIAS_LIMIT=1000
ANONADDY_ADDITIONAL_USERNAME_LIMIT=100
ANONADDY_SIGNING_KEY_FINGERPRINT=66D6C0ABBB32DD0BA4C5502BF34E288EDDEADEA4
ANONADDY_DKIM_SIGNING_KEY=/data/dkim/postx.me.private
ANONADDY_DKIM_SELECTOR=default
MAIL_FROM_NAME=AnonAddy
MAIL_FROM_ADDRESS=mailer@postx.me
POSTFIX_DEBUG=false
POSTFIX_SMTPD_TLS=true
POSTFIX_SMTP_TLS=true
POSTFIX_SMTPD_TLS_CERT_FILE=/data/certs/postx.me.crt
POSTFIX_SMTPD_TLS_KEY_FILE=/data/private/postx.me.key
RSPAMD_ENABLE=true
RSPAMD_WEB_PASSWORD=abc123465jklasdf3416kljasdfklj12345
DNS
Make sure the server's hostname is set to mail.postx.me in /etc/hostname and /etc/hosts.
Set the following DNS records:
A * 144.217.13.168
A mail.postx.me 144.217.13.168
A app.postx.me 144.217.13.168
CAA @ 0 issue letsencrypt.org
CAA @ 0 issuewild letsencrypt.org
CAA @ 0 iodef mailto:caapolicy@postx.me
TLSA _25._tcp.mail 3 1 1 8bf6d7943e7ce273a831ac83faca8b95d740b2f0d73e1336aff2c93fcbf0bc53
TLSA _587._tcp.mail 3 1 1 8bf6d7943e7ce273a831ac83faca8b95d740b2f0d73e1336aff2c93fcbf0bc53
MX @ mail.postx.me 10
MX * mail.postx.me 20
MX unsubscribe mail.postx.me 30
TXT @ "v=spf1 mx ~all"
TXT * "v=spf1 mx ~all"
TXT _smtp._tls "v=TLSRPTv1; rua=mailto:tlsrpt@postx.me"
TXT _dmarc "v=DMARC1; p=none; sp=none; adkim=r; aspf=r; pct=100;"
TXT _mta-sts "v=STSv1; id=1654122691;"
TXT default._domainkey "v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAqYZhrRVjUhalotCM6nc6Gw6CcO0MLkPGpE6R6DLov0BqV5V9FnzED/GHVempI7UoPJ/AEDzjvIAbgkQORD024C4+lArV//eMXYAajPJkDvMtQhbrIV+oBc+0u3mRJQyhLXtO6vA9wfWpbNVivYA71gMPLzng6uIJ5YDCge1R0tqxbPj8cnt0e2VWK1l60CoGKnmfy4pRAWF4u365Tjca2A1Ry1URGyDGImGH6ryOjKeEc/ePWv0r3ig1Ur/cetS9HU8TNJ6UiOjzVTkzglxCSFO1+ryPHucSc/tGmABsovUbp7BeOXZQ0RQZ3iMY9AQ59v4L548ZXrfxclKElZwI4wIDAQAB"
Run the command date +%s to generate a unique value for the TXT _mta-sts id.
Don't add the DKIM or TLSA entry just yet, as the keys/hashes will be generated for that later.
Log into VPS provider and set PTR/reverse DNS record to mail.postx.me.
Make sure the Traefik certs dumper is installed and the cert for postx.me has been dumped to ./data/certs/postx.me.crt.
Run this command to generate TLSA record:
printf '_25._tcp.%s. IN TLSA 3 1 1 %s\n' \
mail.postx.me \
$(openssl x509 -in ./data/certs/postx.me.crt -noout -pubkey |
openssl pkey -pubin -outform DER |
openssl dgst -sha256 -binary |
hexdump -ve '/1 "%02x"')
You can then add the provided hash to the DNS TLSA records. Check if DANE is configured correctly here.
Generate DKIM record with: docker-compose run --entrypoint '' anonaddy gen-dkim, keypair will be saved in ./data/dkim:
default._domainkey IN TXT ( "v=DKIM1; k=rsa; "
"p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAqYZhrRVjUhalotCM6nc6Gw6CcO0MLkPGpE6R6DLov0BqV5V9FnzED/GHVempI7UoPJ/AEDzjvIAbgkQORD024C4+lArV//eMXYAajPJkDvMtQhbrIV+oBc+0u3mRJQyhLXtO6vA9wfWpbNVivYA71gMPLzng6uIJ5YDCge1R0tqxbPj8cnt0e2VWK1l60CoGKnmfy4pRAWF4u365T"
"jca2A1Ry1URGyDGImGH6ryOjKeEc/ePWv0r3ig1Ur/cetS9HU8TNJ6UiOjzVTkzglxCSFO1+ryPHucSc/tGmABsovUbp7BeOXZQ0RQZ3iMY9AQ59v4L548ZXrfxclKElZwI4wIDAQAB"
) ;
Add the value to the default._domainkey TXT record.
Generate PGP key for AnonAddy, which will go in ./data/.gnupg:
docker-compose exec --user anonaddy anonaddy gpg --full-gen-key
Then update the value of ANONADDY_SIGNING_KEY_FINGERPRINT= in anonaddy.env with the fingerprint of that key.
Set ANONADDY_ENABLE_REGISTRATION= to false in anonaddy.env after user(s) created.
Notes
The official Anonaddy documentation shows a setting in /etc/postfix/main.cf:
compatibility_level = 2
Which was absent from the same file in the Docker. Added it manually.