Custom domains

This guide will show you how set up a custom domain on your slot. It assumes you have already made the made the switch to nginx. If you haven't done so, please follow that guide then return here.

You may need to execute some commands via SSH to use this software. There is a separate guide on how to connect to your slot via SSH. Commands are kept as simple as possible and in most cases will simply need to be copied and pasted into the terminal window (then executed by pressing the Enter key).

The guide is split into two sections:

  1. Configuring things at a registrar
  2. Configuring things at Feral

Configuring things at a registrar

The following steps should be broadly similar for all registrars. Double-check the registrar's own documentation for requirements first - if you require a piece of information and are unsure how to obtain it, please open a ticket.

First of all you'll need to get your server's IP. Once you have this, you'll be able to configure the DNS settings of your custom domain.

Your domain registrar or name server host will provide you with basic or advanced tools (a DNS records editor) to manage your DNS settings for each domain they are managing. Access the tools according to the registrar's own documentation / help. There are potentially two things that need to be created - the first is an A record for the main IP and the second a CNAME record for the www version of the domain. Note that some registars will automatically create the CNAME record

.

To create an A record most registrars require the following information:

Host
The domain name you've purchased e.g. example.com
TTL
The "time to live" setting; 1H or 3600.
Type
A
Value / blank input field
Your server's IP (see steps above if you need help with this).

If a CNAME record must be created manually, here is the info you will need (the placeholder example.com is used - replace this with the domain you've purchased):

Host
www.example.com
TTL
1H or 3600.
Type
CNAME
Value / blank input field
example.com

Configuring things at Feral

In order to set things up all you need to do is add a directory for your domain and let the system take care of the rest. To do this, run this command (where example.com is replaced by your actual domain:

mkdir -p ~/www/example.com

A script running on the server will run every five minutes and will configure your domain once it has "seen" it. You can confirm this has happened by checking to see if there's a directory named public_html in your custom domain's directory.

Custom SSL certificates

There is a separate guide to configuring custom SSL certificates.