Definition

You can specify that your service should listen on a custom domain:

services:
  web:
    domain: myapp.example.org
    port: 3000

You can also specify multiple domains using this syntax:

services:
  web:
    domain:
      - myapp.example.org
      - "*.example.org"
    port: 3000

Dynamic Configuration

You can use environment interpolation so that you don't have to hardcode the hostname in your convox.yml:

services:
  web:
    domain: ${HOST}
    port: 3000

Configuring DNS

Run convox rack and find the Router value. Configure your custom domain as a CNAME to this domain.

Example