---
title: "Custom Domain and Emails"
date: "2024-10-07"
tags:
  - dns
  - email
categories:
  - selfhosted
---

# What is this?

Let's say you wanted to buy a domain like `edfig.dev`. You can host a personal blog at this address. Once you buy the domain, not only can you host content, but with a bit more tinkering you can send and receive emails with it.

You can email `eddie@edfig.dev` or `admin@edfig.dev` and that email will make its way to my inbox. You can set up rules to handle specific addresses too.

You'll need to create accounts for the following:
- Mailgun.com
- porkbun.com

# Setting it up

## 1. The Domain

You can buy a domain from any registrar, I recommend [PorkBun](https://porkbun.com/) or [Cloudflare](https://www.cloudflare.com/products/registrar/). I'll be using Porkbun for this discussion.

Pricing will depend on the name and what TLD (the `.com` part). I occasionally run into issues with sites not recognizing `eddie@fig.systems` as a valid email address because it's a lesser known domain.

Once you have it you can enter DNS records to where you host stuff or start using it for email.

## 2. The Email

Email is one of those things you shouldn't host yourself, it's very annoying. But luckily there are services out there that take care of most of the hassle. [MailGun](https://www.mailgun.com/) and [SendGrid](https://sendgrid.com/en-us) are two such services. I'll be using Mailgun here.

With Mailgun I can:
- Receive emails at custom email addresses with my domain
- Route those emails based on rules
  - e.g. Emails sent to `no-reply@edfig.dev` are completely dropped
- Send emails AS those email addresses through gmail
  - Receive an email at `admin@edfig.dev` at my regular gmail account and reply as `admin@fig.systems`
- Use their API to programmatically send emails
- Use their SMTP servers to send as custom email addresses
  - My self hosted services send notification emails as `no-reply@fig.systems` or as `service_name@fig.systems`

## 3. Setting up DNS

1. Buy a domain at porkbun.

Pick your favorite. I'll be using `figgy.foo` for this, there was a good deal on it.

2. Log into Mailgun
- Go to Send -> Sending -> Domains
- Click on "Add New Domain"
- Add `figgy.foo`, leave the rest blank, click Add Domain

3. Add DNS records to porkbun.

You'll be provided with records for sending, receiving, and tracking.

In Porkbun Domain Management select `DNS` when you hover over your new domain.

Copy the entries over. Make sure the Types match and that you leave off the `figgy.foo` portion in the `host` field in porkbun. Anything you add in the host field will automatically append your domain to the end of it. If the field is just `figgy.foo` then leave the host field blank.

Copy all the Value fields from Mailgun to the Answer field in Porkbun and then click on Verify at the top right. You should see the status change to Active.

This is what your records in porkbun should look like.

![porkbun-email-dns-records](/images/porkbunemailrecords.png "A picture showing how porkbun records should look")

## 4. Setting up Mailgun

### Routing emails.

1. Go to Send -> Receiving and Create a Route.

2. Expression Type -> Match Recipient

   - Enter `admin@figgy.foo`

3. Enable Forward and fill in your personal address. For me that'd be my normal gmail address.

4. Set priority to 50 so you have space to add future routes before or after this route.
5. Add a simple description like "send to gmail" and Create the Route.

At the free tier you can only have 5 routes total. I only use the following:

1. Match `no-reply@figgy.foo`, Store and Notify and Stop processing.
2. Match `family@figgy.foo`, forward that email to multiple family members.
    - Useful for events and family plans.
3. Match `Kindle@figgy.foo`, forward to my custom [Amazon provided](https://www.amazon.com/sendtokindle/email) kindle email address for sending epubs/pdfs.
    - much friendlier address than what they make for you.
4. A catch all final route that just forwards to my personal address.

Number 4 is where most of the magic and utility of setting all this up happens. I can give out unlimited custom email addresses and I'll know who sent them by the address. That is, if I give out `businessName@fig.systems` I can later use that in gmail to filter, block, or search for anything related to that business. I can even see who sold my info if I start getting spam from that address.