Custom domains

Your agent gets the exact CNAME from add_domain. Add it at your DNS provider, then wait_for_domain polls until verified and routing is live with automatic TLS.

Every VM gets a default URL (https://vm-abc123-3000.superjolt.host). To serve it on your own domain with automatic TLS, it’s three steps end-to-end.

1. Attach the domain

put www.example.com in front of vm-abc123 on port 3000

Your agent calls add_domain with the domain, the vmId, and the vmPort (must be an HTTP port). The response includes the exact CNAME record to create.

2. Add the CNAME at your DNS provider

Create the CNAME exactly as returned — at your DNS provider, add a CNAME for www pointing at the target hostname. (If your provider proxies, follow the record the response gives you; the target is what matters.)

3. Verify + go live

wait for www.example.com to verify

wait_for_domain polls until the hostname is verified and routing is active — TLS is provisioned automatically. This typically takes from seconds to a few minutes depending on DNS propagation. If it’s stuck, see Troubleshooting.

Managing a domain later

• set_domain_enabled — toggle the public route off/on without losing the DNS setup or TLS.
• repoint_domain — point an already-verified domain at a different VM/port (e.g. after a blue/green swap).
• remove_domain — tear down the public route and DNS entry.