# Setup domain

TIP

Starter license allows only one domain.

# Register a domain

Choose your preferred domain registrar. For example, on namecheap.com.

# Configuring DNS

After the domain is registered, please seek for the DNS configuration for a domain. You must add an A-record.

Setup DNS in Namecheap.com (video)
Setup DNS in Namecheap.com (screenshots)

Go to the Admin Dashboard and click Manage for your domain:

Choose Advanced DNS settings:

Add an A-record:

  • Choose "A Record" in the first column.
  • @ for Host.
  • The server IP as "Value".
  • Select the lowest value for "TTL".

# (Optionally) Enable IPv6 for domain

To plugin domain to the tracker via IPv6 address:

  1. Specify the correct IPv6 of your tracker server in DNS-records managing panel

  2. Add a domain to the tracker at tab Domains-Create

# Adding domain

  1. Open Domains tab.
  2. Press Add button.
  • Domain. Domain name or list of names separated by , (comma).
  • Redirect to HTTPS. Forcefully redirect from http:// to https://.
  • Index page. Use a campaign as an entry page for the domain.
  • Admin Dashboard An ability to open Keitaro Admin Dashboard using this domain name: domain.com/admin. If the access to the Admin Dashboard is denied from all domains, log in to the tracker using the server_ip/admin link. Access to the tracker via IP is managing in Maintenance — Settings.

# SSL certificate (HTTPS)

When DNS is refreshed and domain assigned to the server, the tracker automatically request for SSL certificate.

What are the limits for Letsencrypt?

See https://letsencrypt.org/docs/rate-limits/ page.

How to fix "Request limits exceeded"?

There can only be 5 unsuccessful tries to issue a certificate during an hour. You'll see "Request limits exceeded" error after 5 tries. You need to wait for an hour to try an issue certificate again.

How to fix "Certificate issue is blocked"?

Make sure DNS is configured, upgrade your server, then delete the domain and add it to the tracker again.

# Adding subdomains

Edit domain DNS, add one more A-record, but use the subdomain name instead of @. Then add the subdomain as a standard domain to Keitaro.

# Domains FAQ

Why domain is still unavailable?
  1. Check if A-record is present, whether it's assigned to the correct IP, and no more A-records there.
  2. If AAAA-record is present, make sure it's assigned to the correct IPv6 of the server.
How to check DNS?

Use dnschecker.org or via terminal.

Check for A-records:

dig A yourdomain.com +short
1

Check for AAAA-records:

dig AAAA yourdomain.com +short
1
What if domain works, but SSL is not?

Open domain's SSL log or Maintenance → Logs → SSL Certificates for explanation.

How to configure CloudFlare?

No changes are needed. Just add a domain to CloudFlare. Both Flexible and Full SSL modes are supported.