Skip to main content

Connect your own domain

An Easy Mode app lives at its own jaahai.app address. You can also show it on a domain you own, such as shop.example.com or example.com. Jaah checks your DNS, issues the HTTPS certificate and starts serving the domain by itself. The jaahai.app address keeps working.

You need:

  • Custom domains on your org's plan. Without it, the project page shows no Domains section, or, when the app already has domains, lists them with a line saying adding one needs the plan feature.
  • To be an org Owner or Admin. Project Maintainers, Developers and Viewers see the domains and their status, but cannot change them.
  • Access to the DNS settings where your domain is hosted (your registrar or DNS provider).

Add a domain​

  1. Open the project and stay on General. The Domains section sits under the app's addresses.
  2. Select Add domain and type the domain, for example shop.example.com.
  3. For a root domain (example.com) or its www name, Also connect offers the other one too, ticked by default. Under Main domain (the other one redirects to it), pick which of the two visitors land on.
  4. Select Continue. Jaah shows the records to add, each value with a copy button.
  5. Add the records at your DNS provider, then select Done. You don't need to come back: Jaah keeps checking.

The records for a subdomain such as shop.example.com:

TypeNameValue
TXT_jaah-verify.shopjaah-verify= followed by the code Jaah shows
CNAMEshopconnect.jaahai.app

For a root domain such as example.com, the TXT record's name is _jaah-verify, and the record that points it at Jaah is an ALIAS (also called ANAME, or a flattened CNAME) at @ with the value connect.jaahai.app. Not every DNS provider offers one. If yours doesn't, make www the main domain and set up a forward from the root to www at your registrar.

The TXT record proves the domain is yours. Jaah serves nothing on the domain until it finds it.

It usually takes a few minutes after DNS is right, up to 48 hours. If the domain already showed a site, HTTPS may fail for a few minutes right after you switch, until the certificate is issued.

Read a domain's status​

StatusWhat it means
Waiting for DNSJaah hasn't found both records yet. The line under it names what is missing.
Issuing certificateThe records are right; Jaah is getting the HTTPS certificate.
LiveThe domain shows your app.
Needs attentionSomething stopped working; the line under it says what to fix.
RemovingThe domain is being disconnected.

Check now checks a waiting domain right away; Records shows its records again. A domain still waiting after 7 days is removed, which frees its place. A live domain whose records stop pointing at Jaah moves to Needs attention, and org admins get a notification. Fix the records within 7 days, or the domain is disconnected.

Some reasons you may see:

  • Remove this domain from your old host first. Another service still holds the domain.
  • This domain is connected on Jaah's other environment. Remove it there before adding it here.

Make a domain main​

When an app has more than one live domain, select Make main on the one visitors should land on. The console shows it as the app's address, and its www or root twin redirects to it.

Remove a domain​

Select Remove on the domain and confirm. It stops showing your app within a few minutes. Remove its DNS records at your provider too. Removing works even when Custom domains is no longer on your plan.

Limits​

Each app can have as many domains as your plan allows, two by default (a root and its www). At the limit, Add domain is greyed out and the section says how many your plan allows. Wildcard domains (*.example.com) and Jaah's own domains can't be added, and a domain can be connected to one app at a time.