Help site

The help site is the public help site at your Cactus address, https://{name}.heycactus.ai, or at your own domain once it is live, and this page shows how to set its address and who can read it.

On this page

Set the address

Your help site is at https://{name}.heycactus.ai, where {name} is the name you set for it.

  1. In Connect › Help site, find Address.

  2. In Name, type 3 to 40 characters: lowercase letters, numbers, and single hyphens.

  3. Select Save. The address changes right away, and the old one stops working.

Names the code reserves are refused with "That name is reserved." A name another product already uses is refused with "That name is taken. Try another."

Choose who can read it

In Who can open it, select Public or Team only.

Choice

Who can open the site

Public

Who can open the site

Anyone with the address can read your help site and changelog once its first pages are published.

Team only

Who can open the site

Only people logged in to this product can open it, and visitors see nothing.

With no page listed yet, the site has nothing to show.

A teammate's pass to read a team-only site lasts 12 hours. A teammate opens it through the site's login door, which opens the page they asked for.

The Public and Team only switch has no owner check: any member of the product's team can change it.

Connect your own domain

Only a teamspace owner can connect, check, or remove a domain.

  1. Under Your own domain, type a subdomain such as help.yourcompany.com, then select Connect. Until the domain is live, the site keeps working at its Cactus address.

  2. Where you manage DNS, add a record with Type CNAME, Name set to your domain, and Target customers.heycactus.ai. If your DNS is on Cloudflare, set the record to DNS only.

  3. Watch the status the panel shows until it reads Live.

What you see

What it means

Waiting for DNS

What it means

The domain's hostname is not active yet, so the record is not yet seen.

Issuing certificate

What it means

The hostname is active and the certificate is still being issued.

Live

What it means

The hostname and its certificate are both active.

Needs attention

What it means

A status has stopped, or the domain has an error for more than 10 minutes.

Once the domain is Live, the panel says the Cactus address and every older link send visitors to it.

If the domain needs attention, the panel says what to do. The most common sentences are these:

What you see

What to do

"Add a CNAME from {domain} to customers.heycactus.ai, then check again."

What to do

Add the record, then select Check again.

"{domain} answers with an address, not a CNAME. Replace that record with a CNAME to customers.heycactus.ai, then check again."

What to do

Replace the address record with the CNAME.

"{domain} points at {target}. Point it at customers.heycactus.ai, then check again."

What to do

Point the record at the Cactus target.

"Cloudflare won’t serve this domain. Email the Cactus team, and they’ll look into it."

What to do

Email the Cactus team.

Connecting is refused in these cases, with these sentences:

What you see

What it means

"Use a subdomain such as help.yourcompany.com."

What it means

You typed a bare domain, not a subdomain.

"Cactus can’t find that domain in DNS. Check the spelling."

What it means

No DNS zone answers for the name.

"This product already has a domain. Remove that one first."

What it means

The product has a domain already.

"That domain is connected to another product."

What it means

Another product has the domain.

To remove the domain, select Hold to remove in the panel. After that the site is at its Cactus address again.

Read by AI

The Read by AI panel counts how many times AI read your help pages this week. With no reads yet, it says "No AI has read your help site yet. I’ll tell you here when one does."

For a public site, the panel also shows a git clone command for the help site's /memory.git copy, which holds every public page. Each publish reaches that copy within 5 minutes.

If visitors see "There's no help site here"

Visitors see "There's no help site here" when the site is Team only or the address names no site. To open it to visitors, select Public under Who can open it.

The help site also serves plain-text and markdown copies of its pages for AI tools.

Related pages