FerryDocs
ConceptsServices

Public URLs

A web service or a static site gets a public URL from its name, the default domain and the public port.

Edit on GitHub
Service nameapiDefault domainlocalhostPublic port8080Public URLapi.localhost:8080
The parts of the default URL of a service named api

A web service or a static site gets a . The is the until you connect a domain of your own.

Examples

Server settingsURL of a service named api
Defaults (--base-domain localhost, proxy on :8080)http://api.localhost:8080
--base-domain apps.example.com --proxy-addr 0.0.0.0:80http://api.apps.example.com
Same, with HTTPS (--https-addr and --acme-email)https://api.apps.example.com

The URL has no port when the port is 80 or when HTTPS is on.

More hostnames

Each domain of the server serves the service. If you connect example.com to the server, the service also answers at api.example.com.

A is for one service:

Terminal
ferry domains add api api.example.org

The proxy sends all these hostnames to the service. See Networking, domains & TLS.

On this page