StatusForge
Back to Home

Custom Domain Setup Guide

Learn how to set up a custom domain for your client's status page in just a few minutes.

Overview

Custom domains allow you to host your client's status page on their own domain (e.g., status.clientsite.com) instead of the default StatusForge subdomain.

This guide will walk you through the DNS configuration process with step-by-step instructions for popular DNS providers.

Step-by-Step Setup

1
Configure Custom Domain in StatusForge
  1. Log in to your StatusForge dashboard
  2. Navigate to your client's status page settings
  3. Click on the "Custom Domain" tab
  4. Enter your desired custom domain (e.g., status.clientsite.com)
  5. Click "Save" - you'll see the CNAME record you need to add

Important

We recommend using a subdomain (like status.yoursite.com) rather than your root domain (yoursite.com) for your status page.

2
Add CNAME Record to Your DNS Provider

You need to add a CNAME record that points your custom domain to StatusForge. The exact steps vary by provider:

CloudflareCloudflare

  1. Log in to your Cloudflare dashboard
  2. Select the domain you want to use
  3. Go to the "DNS" section
  4. Click "Add record"
  5. Select "CNAME" as the record type
  6. Enter the subdomain name (e.g., "status" for status.yoursite.com)
  7. For the target, paste: statusforge.app
  8. Set proxy status to "DNS only" (gray cloud icon)
  9. Click "Save"

Type: CNAME
Name: status
Target: statusforge.app
Proxy: DNS only

Namecheap

  1. Log in to your Namecheap account
  2. Go to "Domain List" and click "Manage" next to your domain
  3. Navigate to the "Advanced DNS" tab
  4. Click "Add New Record"
  5. Select "CNAME Record" from the dropdown
  6. For Host, enter your subdomain (e.g., "status")
  7. For Value/Target, enter: statusforge.app
  8. Set TTL to "Automatic" or "1 min"
  9. Click the green checkmark to save

Type: CNAME Record
Host: status
Value: statusforge.app
TTL: Automatic

GoDaddy

  1. Log in to your GoDaddy account
  2. Click on your profile name and select "My Products"
  3. Find your domain and click "DNS"
  4. Scroll to the "Records" section
  5. Click "Add" to create a new record
  6. Select "CNAME" from the Type dropdown
  7. For Name, enter your subdomain (e.g., "status")
  8. For Value, enter: statusforge.app
  9. Set TTL to "1 Hour" (or leave default)
  10. Click "Save"

Type: CNAME
Name: status
Value: statusforge.app
TTL: 1 Hour

3
Verify Your Domain
  1. Wait 5-10 minutes for DNS changes to propagate (can take up to 48 hours in rare cases)
  2. Return to StatusForge dashboard
  3. Go to your status page's Custom Domain settings
  4. Click the "Verify DNS" button
  5. If verification succeeds, you'll see a green checkmark

Success!

Once verified, your status page will be accessible at your custom domain within minutes. SSL certificates are automatically provisioned.

Troubleshooting

DNS verification failing?

  • Wait at least 10-15 minutes after adding the CNAME record
  • Make sure you're pointing to statusforge.app (not www.statusforge.app)
  • Check that you haven't added a trailing dot after the target
  • If using Cloudflare, ensure proxy is disabled (DNS only / gray cloud)
  • Clear your local DNS cache or try verification from a different network

Certificate errors?

SSL certificates are provisioned automatically after DNS verification. This usually takes 5-10 minutes. If you see certificate warnings, wait a few minutes and try again.

Still having issues?

Contact our support team at support@statusforge.app and include your domain name and DNS provider.

Ready to Set Up Your Custom Domain?

Log in to your dashboard or start your free trial to get started.