explaingit

anonaddy/anonaddy

4,635PHPAudience · generalComplexity · 3/5Setup · moderate

TLDR

AnonAddy (addy.io) lets you create disposable email aliases that forward messages to your real inbox, keeping your actual address private. You can reply through aliases, encrypt forwarded emails with GPG, use your own custom domain, or self-host the entire system on your own server.

Mindmap

mindmap
  root((AnonAddy))
    Aliases
      Create disposable address
      Deactivate or delete
      Reply anonymously
    Privacy
      No email storage
      No ads or analytics
      Open source code
    Encryption
      GPG key support
      OpenPGP forwarding
      Transit protection
    Domains
      Shared service domain
      Custom domain support
      Self-hosted option
    Apps
      Browser extensions
      Android and iOS
      Raycast extension
    Plans
      Free tier basics
      Paid alias limits
      Extra usernames
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Protect your real email when signing up for websites, newsletters, or apps you do not fully trust.

USE CASE 2

Stop spam by deactivating an alias the moment it starts receiving unwanted messages.

USE CASE 3

Reply to emails without ever revealing your actual inbox address to the other person.

USE CASE 4

Run your own private email alias server so you are not dependent on any third-party service.

Tech stack

PHPGPG/OpenPGPEmail forwardingREST APISelf-hostingMySQL

Getting it running

Difficulty · moderate Time to first run · 1h+

Self-hosting requires a working mail server, PHP environment, and DNS configuration. The hosted service at addy.io works immediately with no setup. FAQ in the README covers self-hosting steps.

Open source and publicly available, you can inspect, self-host, and modify the code. Check the repository for the specific license terms.

In plain English

AnonAddy, now operating under the name addy.io, is a service that lets you create disposable email addresses that forward messages to your real inbox. Instead of giving your actual email address to every website you sign up for, you give them an alias. Emails sent to that alias are forwarded to you, but the recipient never learns your real address. If you start receiving spam, you can simply deactivate or delete that alias without affecting your main inbox. The system also lets you reply to forwarded emails through the alias, so the person you are replying to still sees only the alias address, not your real one. You can attach your own GPG or OpenPGP encryption key to your account so that emails forwarded to you are encrypted before they arrive in your inbox, making them unreadable to anyone who might intercept them in transit. You can use a shared domain provided by the service, or point your own custom domain at the system. The project describes itself as privacy-focused. It does not store emails unless delivery fails and you have chosen to enable that option. It does not include advertising or analytics. The source code is open and publicly available so anyone can inspect how the system works. It can also be self-hosted, meaning you can run your own copy of the software on your own server if you do not want to rely on the hosted service at addy.io. Browser extensions, Android and iOS apps, and a Raycast extension are available for easier alias creation on the go. Paid subscriptions unlock higher limits on the number of aliases and additional usernames. The free tier includes basic alias creation with a bandwidth cap. This repository is the PHP backend that powers addy.io. Self-hosting instructions are included in the FAQ section of the README. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
I want to self-host AnonAddy on my own server. Walk me through the setup steps from the README, including what environment variables and mail server settings I need to configure.
Prompt 2
How do I add my own custom domain to AnonAddy so that aliases use my domain instead of the shared one? What DNS records do I need to set up?
Prompt 3
I want to enable GPG encryption on my AnonAddy account so forwarded emails are encrypted before they reach my inbox. How do I add my public key and what does the encryption cover?
Prompt 4
Help me use the AnonAddy API to automatically create a new alias whenever I sign up for a service, and store the alias-to-service mapping in a spreadsheet.
Prompt 5
What are the differences between the free and paid tiers of AnonAddy, and at what point should I consider upgrading or switching to self-hosting?
Open on GitHub → Explain another repo

← anonaddy on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.