Custom domains

Every project has a platform address on app.vinssi.ai. You can serve the same app from your own hostname. TLS certificates are issued automatically once the domain is verified.

Steps

  1. Open Settings → Domains on the project and add the hostname, for example app.example.com. Vinssi shows two DNS records to create.
  2. At your DNS provider, add the TXT record for verification. The host is _vinssi-challenge.app.example.com and the value looks like vinssi-domain-verification=…. For a two-label domain such as example.com the host is _vinssi-challenge.example.com.
  3. Add a CNAME record pointing the hostname at the project's platform address, shown as the CNAME target on the same page.
  4. Wait for DNS to propagate, then choose Verify. Vinssi looks up the TXT record itself; if it is not visible yet, the error message repeats the exact record to add.

After verification the hostname is added to the project's routing and a certificate is requested. The domain shows as Configured once both are done, usually within a minute or two.

What is accepted

  • A bare hostname or a full URL; the scheme and path are stripped.
  • Hostnames with at least two labels. IP addresses and localhost are rejected.
  • A hostname can be verified on one project at a time. To move it, remove it from the old project first.
  • Hostnames under Vinssi's own domains cannot be added.

Root domains

CNAME records are not allowed at the root of a zone by the DNS standard. Use a subdomain such as www.example.com, or a DNS provider that offers CNAME flattening or ALIAS records at the apex. Vinssi does not publish a fixed IP address for A records.

Removing a domain

Choose Remove next to the domain. Routing is updated first, then the record is deleted. Traffic to the hostname stops resolving within seconds.

Locked while deletion is scheduled

Domains cannot be added, verified or removed while a project is scheduled for deletion. Cancel the deletion first.