Links

Multi Server DNS Setup

The goal of this section is to get your DNS setup for your portal. For multi-server portals, this requires A records and a load balancer.
NOTE: Currently, this documentation is set up to walk you through using AWS for your DNS management.
NOTE: You will get charges for your AWS usage. Even on our large portals, these charges have been minimal. Current rates as of Feb 2022, are $0.50 for a hosted zone and $0.40 per million queries. Most small portal operators will see less than $1 in AWS usage.

Account Creation

If you already have an AWS account you can skip this section, if not, continue on.
Head to aws.amazon.com and create an AWS account. You will want to create an account as a root user.

AWS

Currently, this documentation is set up to walk you through using AWS for your DNS management.

Route53

Hosted Zones

Once you have created an account and logged in, head to Route53. You can find this under Services or by searching for it in the search bar.
In Route53, click on Hosted Zones and create a new hosted zone. This hosted zone should be public and is the domain that you purchased for your portal.

Nameservers

Once your hosted zone is set up, AWS will have populated a nameserver NS record for your domain. Typically there are 4 nameservers listed in the NS record. You will need to update the nameservers for your domain where you purchased and managed your domain.
If you happen to purchase your domain through NameCheap, you can update your nameservers by clicking on your domain, selecting the Custom DNS option under NameServers, and copying in the name servers that AWS generated for you.

A Records

Single Server A Records

After you have created your hosted zone, you can now create additional DNS records.
The process for setting A records for a multi-server portal is the same as for a single server portal, with the only change being the A record pointing to the server domain instead of the portal domain.
So if your portal domain is mydomain.com and you're setting up a server at sev1.mydomain.com, you would have an A record for sev1.mydomain.com pointing to the IP of the server and a wildcard A record for *.sev1.mydomain.com pointing to the first record sev1.mydomain.com.
First, you will want to create an A Record that points from your domain to your server's IP address.
Next, you will want to create a wildcard A record. To do this, you create an A record, select the alias option and find the A record that you just created that points to the server IP. For the value of Record name place an asterisk (*).

CNAME Record

If you want your domain to be accessible at both mydomain.com and www.mydomain.com you will need to add a CNAME record for www that points to mydomain.com like so:

Verify

DNS records can sometimes take a while to update. However, you will know that everything is set up properly when you can ssh into your server with the domain name instead of the IP address, like so:
# Multi-Server Portal

Access Key

For certbot, you will need an AWS access key, so you will need to generate an access key for your account.
Click on Security Credentials in your account dropdown menu.
Under Access keys, click Create New Access Key.
Hold on to these and we will use them when we are setting up the portal.
The AWSAccessKeyID is the aws_access_key and the AWSSecretKey is the aws_secret_access_key.

Load Balancer

If you are running a multi-server portal, you will need to set up a load balancer to load balancer your domain across your servers.

Load Balancer Setup

Coming soon...