Custom Domains

Custom domains allow you to serve your documentation from your own URL, like docs.yourcompany.com instead of cirth.app/docs/your-project.

Why Use a Custom Domain?

• Brand consistency - Keep users on your domain

• Professional appearance - Look more established

• SEO benefits - Build authority on your domain

• Trust - Users stay within your brand experience

Setting Up a Custom Domain

Step 1: Add Your Domain

1. Go to your Project Settings

2. Navigate to the Domains tab

3. Click Add Domain

4. Enter your domain (e.g., docs.example.com)

5. Click Add

Step 2: Configure DNS

You'll need to add DNS records with your domain provider:

For Subdomains (Recommended)

Add a CNAME record:

For Apex Domains

Add an A record:

Step 3: Verify Domain

1. After adding DNS records, return to Cirth

2. Click Verify next to your domain

3. Wait for DNS propagation (usually 1-24 hours)

4. Once verified, your domain shows a green checkmark

Step 4: SSL Certificate

Cirth automatically provisions an SSL certificate:

• Certificates are issued via Let's Encrypt

• HTTPS is enabled automatically

• Certificates renew automatically

DNS Propagation

DNS changes can take time to propagate:

Tip: Use dnschecker.org to monitor propagation.

Common DNS Providers

Cloudflare

1. Log into Cloudflare dashboard

2. Select your domain

3. Go to DNS > Records

4. Click Add Record

5. Set proxy status to DNS only (gray cloud)

GoDaddy

1. Log into GoDaddy

2. Go to My Products > DNS

3. Click Add under Records

4. Select record type and enter values

Namecheap

1. Log into Namecheap

2. Go to Domain List > Manage

3. Click Advanced DNS

4. Add new record with provided values

Troubleshooting

Domain Not Verifying

• Check DNS records - Ensure they match exactly

• Wait for propagation - May take up to 48 hours

• Check for conflicts - Remove duplicate records

• Disable proxy - Cloudflare proxy can interfere

SSL Certificate Issues

• Wait 10 minutes - Certificate provisioning takes time

• Check domain is verified - SSL requires verification first

• Clear browser cache - Old certificates may be cached

Domain Shows Wrong Content

• Clear CDN cache - If using Cloudflare, purge cache

• Check CNAME target - Ensure it points to correct value

• Verify project settings - Confirm domain is linked to correct project

Multiple Domains

You can add multiple domains to a single project:

• docs.example.com (primary)

• documentation.example.com (alias)

• help.example.com (alias)

All domains serve the same content.

Removing a Domain

1. Go to Project Settings > Domains

2. Click the trash icon next to the domain

3. Confirm deletion

Note: Remember to remove DNS records from your provider.

Best Practices

1. Use subdomains - docs.example.com is easier to set up than example.com/docs

2. Choose memorable names - docs, help, guide are common choices

3. Set up redirects - Redirect www.docs.example.com to docs.example.com

4. Monitor uptime - Set up monitoring for your custom domain