Go live

Connect a custom domain

Connect a domain you own, such as app.yourcompany.com, to your app on a Pro plan or higher, and check that it is live.

On this page

Availability. Custom domains need a Pro plan or higher (or an organisation without plans, such as an enterprise contract) and permission to edit the app. On a plan without them, the app's Domains page shows Use your own domain with an upgrade offer instead of the form.

A custom domain lets people open your published app at a name you own, such as app.yourcompany.com. The app's built-in Ahamo address keeps working beside it.

When to use it

  • You want to share the app under your own brand rather than an ahamo.app address.
  • You already own the domain and can change its DNS records at the company that runs them (your registrar or DNS provider).

To change the built-in Ahamo address instead, see Understand app addresses.

Connect the domain

  1. Open the app and choose Domains. You can also get there with Use custom domain in the publish review, or Add a custom domain on the chat's publish card.

  2. Under Custom domains, enter the name you want, such as app.yourcompany.com, and choose Add. A pasted address such as https://app.yourcompany.com/ is fine, because Ahamo keeps only the name.

  3. Ahamo shows the DNS records the name needs, each with a copy button:

    TypeWhat it doesNameValue
    CNAMEPoints the name to AhamoYour name, such as app.yourcompany.comThe address Ahamo shows
    TXTProves the domain is yours_ahamo-verify. followed by your nameThe code Ahamo shows

    Sometimes a third record appears, marked Lets the certificate be issued. Add it too.

  4. Add the records at your DNS provider, copying each name and value exactly.

  5. Wait for the status to change. It moves from Waiting for DNS to Verifying, Issuing certificate and Live, and updates on its own. Ahamo checks every minute at first and less often later, at least once an hour. Choose Check now to check at once.

  6. Open the name in a private browser window and check that it shows the published app.

The domain then shows Live. If the app is not published yet, it shows Ready, waiting for publish and starts serving when you publish the app.

Use a name under your domain, such as www.yourcompany.com or app.yourcompany.com. A whole domain such as yourcompany.com or yourcompany.co.uk can't point to Ahamo, because it can't hold a CNAME record.

Remove a domain

Choose Remove next to the domain and confirm. The domain stops working at once and its certificate is deleted. You can then delete its records at your DNS provider.

Plans and limits

FreeProTeamEnterprise
Custom domainsNot includedIncludedIncludedIncluded
  • Who can connect one? Anyone who can edit the app.
  • Time to set up. Ahamo checks the records for 7 days after you add the domain. After that it shows Expired; fix the records and choose Check now to start again.
  • After it is live, Ahamo checks the records again every day. If they no longer point to Ahamo, the domain shows Disconnected and stops serving until they are fixed.
  • Buying a domain. Search for a new domain shows which names are free, but buying one in Ahamo is not available yet. Register it with a registrar and connect it here.

Troubleshooting

The status stays on Waiting for DNS. The message under the domain names the record Ahamo looked up, what it found and what it expected. Correct that record. Some DNS providers add your domain to every name you type, and if yours does, enter only the part before it, such as _ahamo-verify.app for app.yourcompany.com. DNS changes usually show within minutes but can take a few hours.

The record points somewhere else. The CNAME record of the name points to another address. Change its value to the one Ahamo shows.

The domain is refused. The message says why:

  • is a whole domain, so use a name under it, such as www. or app. followed by your domain.
  • belongs to Ahamo or a hosting service, so use a name under a domain you own.
  • is already connected to Ahamo, so the name is in use by another app or organisation. If it is yours, remove it where it was added first.
  • needs a plan that includes custom domains, so move the workspace to Pro or higher.
  • The organisation has reached its number of domains, so remove a domain you no longer use first.

The records were not set up within 7 days. Ahamo stopped checking. Fix the records, then choose Check now.

The domain shows Disconnected. Its records changed after it went live. Put back the records Ahamo shows; Ahamo checks again on its own.

The name is already connected to another service. Remove it from that service, or use another name.

On this page