FerryDocs
GuidesConnect a domain

Manage domains

List the domains of the server, test one, change the default, or disconnect one.

Edit on GitHub
Terminal
ferry domains                          # the domains, their status, the record to create
ferry domains verify example.com       # check now
ferry domains default example.com      # the domain service URLs are shown with
ferry domains disconnect example.com   # services stop being served under it
ferry certificates                     # every hostname with the state of its certificate

Disconnect a domain

  • Ferry no longer serves the services under the domain. This is immediate.
  • The DNS records stay at your DNS provider.
  • If it was the default domain, the becomes the default again.

The rules

DomainRule
The base domain (--base-domain)Ferry always serves it. You cannot disconnect it. To change it, change the option.
A (*.localhost, .test, .internal, .local)It needs no DNS. Ferry does not verify it. It gets no certificate.
A connected domainA server can have 20 connected domains at most.

The default domain

Ferry serves a service under each domain of the server, but shows its URL with one domain.

The public address of the server

The DNS records point to the address that the internet uses to reach the server. Ferry finds it.

On this page

Disconnect a domainThe rules