Anonymous Email Forwarding

This is the source code for self-hosting addy.io.

FAQ

• Why is it called addy.io?
• Why did you make this site?
• Why should I use addy.io?
• Do you store emails?
• What is a shared domain alias?
• What is a standard alias?
• Can I use my own domain?
• Can I add a domain and also use it as a recipient?
• Can I add a domain if I'm already using it for email somewhere else?
• Why should I use this instead of a similar service?
• Is there a browser extension?
• Is there an Android app?
• Is there an iOS app?
• Is there a Raycast extension?
• How do I add my own GPG/OpenPGP key for encryption?
• Are attachments encrypted too?
• Are forwarded emails signed when encryption is enabled?
• Can I reply/send from aliases using encryption?
• Is my public GPG/OpenPGP key removed when I reply/send from an alias?
• Can I mark emails forwarded to me by addy.io as spam?
• Can I use aliases to create multiple accounts on other websites and services?
• Can I have multiple Free accounts?
• What if I don't want anyone to link ownership of my aliases together?
• Where is the server located?
• What if I don't trust you?
• What is the maximum number of recipients I can add to an alias?
• What happens when I delete my account?
• Does this work with any email provider?
• How do I reply to a forwarded email?
• I'm trying to reply/send from an alias but the email keeps coming back to me, what's wrong?
• I'm trying to reply/send from an alias but it is rejected, what's wrong?
• I've been forwarded an email with a red warning banner saying it may have been spoofed, what does it mean?
• Does addy.io strip out the banner information when I reply to an email?
• How do I send email from an alias?
• Will people see my real email if I reply to a forwarded one?
• Can emails have attachments?
• What is the max email size limit?
• What happens if I have a subscription but then cancel it?
• If I subscribe will Stripe see my real email address?
• Do you offer student discount?
• How do you prevent spammers?
• What do you use to do DNS lookups on domain names?
• Is there a limit to how many emails I can forward?
• Is there a limit to how many aliases I can create per hour?
• How is my bandwidth calculated?
• How many emails can I receive before I go over my bandwidth limit?
• What happens if I go over my bandwidth limit in a given month?
• Can I login using an additional username?
• I'm not receiving any emails, what's wrong?
• I'm having trouble logging in, what's wrong?
• How do I know this site won't disappear next month?
• What happens to addy.io if you die?
• Is the application tested?
• How do I host this myself?
• Who's behind addy.io?
• I couldn't find an answer to my question, how can I contact you?

Why is it called addy.io?

Addy is short for "Address". The word "Addy" is internet slang for an email address, e.g.

"My addy is being spammed. I should've kept it private."

Why did you make this site?

I made this service after trying a few other options that do a similar thing. I was really interested in how they worked and loved the thought of protecting my real email addresses from spam.

I also wanted to address some issues with other services such as:

• Proprietary closed source code
• Adverts, analytics and trackers used on the sites
• No option to encrypt emails using a GPG/OpenPGP key
• No option for multiple recipients

I made the code open-source to show everyone what was going on behind the scenes and to allow others to help improve the application.

I use this service myself for the vast majority of sites I'm signed up to.

Why should I use addy.io?

There are a number of reasons you should consider using this service:

• Protect your real email address from spam by simply deactivating/deleting aliases that receive unsolicited emails
• Identify who has sold your data by using a different email address for every site
• Protect your identity in the event of a data breach by making it difficult for hackers to cross-reference your accounts
• Prevent inbox snooping by encrypting all inbound emails using GPG/OpenPGP encryption
• Update where emails are forwarded without having to go through and change your email address for each site individually
• Reply to forwarded emails anonymously without revealing your true email address

Do you store emails?

Emails are only ever stored in the event of a failed delivery, and only if you have this option enabled in your account settings.

What is a shared domain alias?

A shared domain alias is any alias that has a domain name that is also shared with other users. For example anyone can generate an alias with the @anonaddy.me domain. Aliases with shared domain names must be pre-generated and cannot be created on-the-fly like standard aliases.

What is a standard alias?

A standard alias is any alias that can be created on-the-fly. Automatic on-the-fly alias creation is only available for domains that are unique to you. For example, your unique username subdomain, any additional usernames or any custom domains. So if you signed up with the username "johndoe", any alias you create using @johndoe.anonaddy.com would be a standard alias (even if you've generated a Random Character/Random Word one).

Can I use my own domain?

Yes you can use your own domain name so you can also have *@example.com as your aliases. To do so you simply need to add a TXT record to verify your ownership of the domain. Then you will need to add an MX record to your domain so that our server can handle incoming emails. You can then add a few other records to enable sending from your domain too.

Can I add a domain and also use it as a recipient?

No, you cannot use the same domain as a custom domain and also for a recipient on addy.io.

e.g if you add "example.com" as a custom domain, you cannot then add "xyz@example.com" as a recipient. This is because a domain cannot direct email to multiple locations simultaneously using MX records. So your email would arrive for "example.com" and then attempt to be forwarded to "xyz@example.com" which would create a loop.

You can instead use a subdomain for your custom domain, e.g. "mail.example.com" instead of "example.com", this would allow you to create *@mail.example.com for your aliases. More details can be found here.

Can I add a domain if I'm already using it for email somewhere else?

If you have a custom domain say example.com and you are already using it for email somewhere else e.g. ProtonMail or Namecheap then you cannot also use it simultaneously with addy.io.

This is because emails cannot be handled by multiple different mail servers at the same time, even if they have the same priority MX records. It can only be delivered to one mail server at a time which will typically be the MX record with the smallest number since this has the highest priority.

You can either:

• Migrate your domain to addy.io by removing the current provider's MX records and adding addy.io's.
• Or, if you would like to keep using your domain with your current email provider then I would recommend instead adding a subdomain of it to addy.io such as mail.example.com.

Using a subdomain will not interfere with your current email setup and you'll be abl