Domains & networking

Custom domains

Attach your own hostname to a Deploy Hatch project and keep it routed across healthy redeployments.

1. Open the project Domains page and select the intended environment

Open the project Domains page and select the intended environment.

2. Add the hostname you want Deploy Hatch to serve

Add the hostname you want Deploy Hatch to serve.

3. Create the TXT ownership record and point the hostname at the exact DNS target shown by Deploy Hatch

Create the TXT ownership record and point the hostname at the exact DNS target shown by Deploy Hatch. Use the hostname only; do not include https:// in DNS records.

4. Run verification after DNS has propagated

Run verification after DNS has propagated. If a healthy web deployment already exists for that environment, Deploy Hatch attaches the verified domain to it automatically.

5. Deploy Hatch provisions HTTPS through the ingress proxy and marks SSL active only after the custom hostname itself responds over HTTPS

Deploy Hatch provisions HTTPS through the ingress proxy and marks SSL active only after the custom hostname itself responds over HTTPS.

6. Future healthy redeployments automatically move the custom domain to the replacement deployment

Future healthy redeployments automatically move the custom domain to the replacement deployment. No customer DNS change is required.

7. Before removing previous external routing, open the custom hostname and confirm the intended application is being served

Before removing previous external routing, open the custom hostname and confirm the intended application is being served.