Skip to content

Go to the docs contents

Custom domain

Your app answers at your address, like planning.acme.com, with its HTTPS certificate. Your agent declares the domain, and you add the DNS records it gives you.

Updated November 21, 2026.

View as Markdown

Custom domain for your app, like planning.acme.com: your own nameplate screwed onto the app, with its HTTPS certificate

You, to your AI: Put the app on planning.acme.com.

What your agent writes

Your agent writes it in while.yaml, at the root of your app:

while.yaml
apiVersion: while/v1
project: my-app
services:
  - name: web
    port: 3000
    domains: [app.example.com]

When to use it

Use it when the app must live at your address.

How it works

Your app answers at your address, like app.example.com, with its HTTPS certificate. while verifies the domain with a DNS record, then serves it and routes it to the right version.

What to know

A subdomain points to edge.while.cloud with a CNAME. A bare domain (example.com) takes an ALIAS, an ANAME or a flattened CNAME to that same name, if its DNS provider supports it (Cloudflare, Bunny, OVH…). As a last resort only, it takes the A and AAAA addresses of while’s entry point instead, given with the proof (TXT): they can change, a change is announced at https://app.while.sh/v1/network, and while then warns the domains that point to them. The domain is checked every five minutes. Once proven, it is served one to two minutes later, at the latest at the next release. It needs its route, then its certificate, issued on its first visit: verify_domain waits until then. A preview serves only its while addresses, without the domains in while.yaml.

Your agent’s MCP tools

Your agent handles it with the get_app_status tool.

Guides

Give your AI the message, and it takes care of the rest

Give this to your AI

Read while.sh/agents and help me get started with while.

Copy the message

In 3 minutes, with no sign-up, the tool has its own address. To keep it, create your account.

For a company project, write to the while team: hello@while.sh