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
- Open the project and stay on General. The Domains section sits under the app's addresses.
- Select Add domain and type the domain, for example
shop.example.com. - For a root domain (
example.com) or itswwwname, 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. - Select Continue. Jaah shows the records to add, each value with a copy button.
- 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:
| Type | Name | Value |
|---|---|---|
| TXT | _jaah-verify.shop | jaah-verify= followed by the code Jaah shows |
| CNAME | shop | connect.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
| Status | What it means |
|---|---|
| Waiting for DNS | Jaah hasn't found both records yet. The line under it names what is missing. |
| Issuing certificate | The records are right; Jaah is getting the HTTPS certificate. |
| Live | The domain shows your app. |
| Needs attention | Something stopped working; the line under it says what to fix. |
| Removing | The 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.
Related
- What a project's Settings › General holds: Projects.
- What a project is and what its settings decide: How projects work.
- Who holds the org Owner and Admin roles: How team and access work.