Skip to content

Using a Custom Domain Name

If you want complete control of the domain name associated with your EC2, you can customise it in one of two ways.

Route53 Root Domain is Optional

dns53 will automatically append the Route53 root domain when creating the A-Record. Feel free to omit this when providing a custom domain

Static Domain

dns53 --domain-name "my.ec2"

Templated Domain

A templated domain leverages the text templating capabilities of the Go language to replace named fields with concrete values. A list of supported named fields can be found here.

dns53 --domain-name "{{.IPv4}}.{{.Region}}"

Domain Validation

A custom domain must be valid before assigning it to your EC2 instance. A series of checks must pass.

A domain must:

  • not contain leading or trailing hyphens (-) and dots (.)
  • not contain consecutive hyphens (--) or dots (..)
  • not contain whitespace ()
  • only contain valid characters from the sequence [A-Za-z0-9-.]

dns53 will automatically clean any domain name in an attempt to enforce these validation checks.