Custom Domain

Your Kimai-Cloud can be hosted under your own domain name and SSL certificates are supported as well.

This feature allows to run your time-tracking cloud at a custom-domain (eg. https://time-tracking.example.com) instead of only using the generic cloud domain (eg. https://your-name.kimai.cloud).

All you need is your own domain name and access to the DNS settings of that domain. You have to create a so called CNAME (short for "Canonical name") entry, with your cloud domain as destination.

Configure your DNS

Here is an example screenshot of such a DNS setting:

It is unlikely that you need it in this syntax, but in "technical speech" this would be:

time.kevinpapst.de.  IN CNAME kevin.kimai.cloud.

This example shows the custom domain time.kevinpapst.de configured to point to the Kimai-Cloud domain kevin.kimai.cloud. As you can see: cloud name and subdomain name do not have to match.

Be aware that a CNAME record can only be used, if your domain already has an A record:

www.kevinpapst.de.   IN A     192.168.0.1.
time.kevinpapst.de.  IN CNAME kevin.kimai.cloud.

You can also point to a top-level domain, it doesn't have to be a subdomain.

Configure custom domain

In the last step you enter your domain in your profile under Custom domain:

It usually takes a couple of hours until our system are able to utilize this new domain, especially if you tested the integration before creating the DNS entry. In that case our servers will have to wait until new DNS information are available (the waiting time depends on your TTL).

After the custom domain and SSL certificate were successfully activated, you will be informed by email.

SSL certificate

Kimai-Cloud domains always require the use of SSL. After registering the custom domain in our system, an SSL certificate is issued (via LetsEncrypt) on your behalf for this domain.

Costs

There are no additional costs involved with the certificate or the custom domain feature, it is included in your paid plan.