FerryDocs
ConceptsNetworking, domains & TLS

Custom domains

A custom domain is one more hostname for one web service or static site.

Edit on GitHub
shop.localhostdefault hostshop.example.comcustom domainwww.example.comcustom domainProxyshopweb service

The service shop answers at its default host.

1 / 3

A is one more for one or . The routes it when you add it. No deploy is necessary.

The rules

  • The domain must be a valid DNS name with one dot or more. It cannot be an .
  • Ferry stores it in lower case, with no dot at the end.
  • A domain belongs to one service.
  • It cannot be the default host of a service: <name>.<domain> under a domain of the server.
  • It cannot be the dashboard host.
  • Point the DNS of the domain at your server. Use an A/AAAA , or a CNAME to a name that resolves to it.

Add a custom domain

Terminal
ferry domains add shop shop.example.com
# Added shop.example.com. Point its DNS (A/AAAA or CNAME) at this server.
ferry domains shop            # list
ferry domains rm shop shop.example.com

For the complete procedure, follow Custom domains & HTTPS.

The status of a domain

Ferry tests a connected domain until a request for a name under it comes back to this server.

Automatic HTTPS

Ferry gets one certificate for each public hostname from Let's Encrypt, with the HTTP-01 challenge.

On this page

The rulesAdd a custom domain