FerryDocs

Domains

The domains key gives custom domains to a web service or a static site.

Edit on GitHub
ferry.yaml
services:
  - type: web
    name: web
    domains:
      - app.example.com

A is one more hostname for one service. See Custom domains.

The key

KeyTypeDefaultFerry setting and notes
domainslist of stringsnonecustom_domains, for web services and static sites.
  • If the entry has no domains, a service that exists keeps its domains.
  • When domains changes, Ferry refreshes the routes. It starts no deploy.

If a domain is in use

A domain can be on one service only.

StatusMessageCause
409service 'web': domain 'app.example.com' is already used by service 'old-web'A service that is not in the blueprint has the domain.
400Two entries of the file have the same domain.

On this page