DocumentaciónHelp

Connect a custom domain

Also publish your help center on a domain of your company, like ayuda.tuempresa.cl, with a CNAME record pointing to proxy-itsm.argunis.com.

On this page

Besides its argunis.com address, your help center can answer on a domain of your company, for example ayuda.tuempresa.cl. You add it in Elion ITSM, create a record in your domain's DNS, and the HTTPS certificate is issued automatically.

Before you start

  • You need the administrator level in Settings (Administrator role).

  • The help center must be activated. Read Activate the help center.

  • You need access to the panel where your domain's DNS is managed (your domain or DNS provider), or to the person who manages it.

  • Use a subdomain, like ayuda.tuempresa.cl or docs.tuempresa.cl. The root domain (tuempresa.cl) does not work, because it does not allow this type of record.

  • Your plan sets how many custom domains you can have. The badge next to the Custom domains title shows how many you use, for example 0 of 1.

Steps

1. Add the domain in Elion ITSM

  1. Go to Settings → Help center and open the Custom domains tab.

  2. Click Add domain.

  3. In Domain, enter the name, for example ayuda.tuempresa.cl. If you paste a full address with https://, Elion ITSM keeps only the name.

  4. Click Add.

You see the message Domain added: create the DNS record shown and the domain appears in the list with the status Waiting for DNS.

If the name does not work, the form tells you why, for example:

  • Use a subdomain (for example help.tuempresa.cl): the root domain does not allow CNAME.

  • argunis.com domains are assigned by Argunis: enter a domain of your company here.

  • Write domains with accented characters in punycode (xn--…). If your domain has accents or the letter ñ, enter it in the xn--… form your provider gives you.

  • That domain is already added.

2. Create the records in your DNS

Under the domain there is a table with the records you must create, with the columns Type, Name and Value:

Type

Name

Value

Purpose

CNAME

ayuda.tuempresa.cl

proxy-itsm.argunis.com

Points the domain to your help center

TXT (if shown)

the one in the table

the one in the table

Proves the domain is yours or Validates the HTTPS certificate

  1. Go to your domain's DNS panel.

  2. Create a CNAME record:

    • in the name, enter what it says after in your panel: under the name. For ayuda.tuempresa.cl it is just ayuda, because almost all panels fill in the rest;

    • in the value or target, enter proxy-itsm.argunis.com. Use the Value button to copy it.

  3. If the table shows TXT records, create them too, copying their Name and Value with the buttons on each row.

  4. Save the changes in your DNS panel.

If your domain's DNS is in Cloudflare, leave the CNAME as DNS only (gray cloud), not with the proxy turned on.

Elion ITSM never changes your domain's DNS: it only tells you which records to create.

3. Wait until it is active

The domain status moves forward on its own. Elion ITSM checks it one minute after you add it and then every 5 minutes. Under the status you see when it was last checked, for example Checked 3 min ago.

Status

What it means

What to do

Waiting for DNS

It does not see the record yet.

Create the record in your domain's DNS. It can take from minutes to a few hours to propagate.

Verifying

The DNS already points correctly and the HTTPS certificate is being issued.

Wait.

Active

Your help center answers on this domain over HTTPS.

Nothing. Click Open to see it.

Failed

The domain could not be validated. The reason appears below.

Check the records and click Check now.

While the domain is Waiting for DNS, Verifying or Failed, you can click Check now to query the status right away, without waiting for the next check.

What happens next

With the domain Active:

  • your help center answers on your domain and also at its argunis.com address;

  • the records table is hidden. To see it again, click Show DNS records (and Hide records to close it). Do not delete the CNAME from your DNS while you use the domain;

  • if you pause the help center, it also stops answering on your domain.

Remove a domain

  1. On the Custom domains tab, click Remove on the domain.

  2. Confirm with Remove.

You see Domain removed. The help center stops answering on that domain immediately and the domain no longer counts toward your plan's limit. You can then delete the CNAME from your DNS.

If you see Domain removed: Cloudflare did not respond and it will finish deleting there in a few minutes, you do not need to do anything else: the domain no longer answers and the deletion finishes on its own.

Plan domain limit

When you use all the custom domains in your plan, the Add domain button is disabled and you see You have used all the custom domains in your plan. Remove one or ask Argunis to raise the limit.

If you see a domain in the list with the label by Argunis, Argunis assigned it on its own domain: you do not need to create records, it cannot be removed from here and it does not count toward your limit.

If you see Custom domains are not enabled in this environment yet (the Cloudflare connection is missing). Let Argunis know., the problem is not on your company's side: let Argunis know.

Related

Search Elion ITSM

Type at least 2 characters to search Elion ITSM.

↑↓ to navigate · Enter to open · Esc to close