Set Up Custom Domains

Platform Updated: Nov 12, 2025 • 8 min read

Connect your existing domain to your .git project to serve your application under your own brand. This guide covers DNS configuration, verification, and automatic SSL provisioning.

ℹ️

Requirement: Custom domains are available on Pro and Enterprise plans. Free-tier projects can only use the default *.git.dev subdomain.

Prerequisites

A registered domain name (from any registrar: Namecheap, Cloudflare, GoDaddy, etc.)
Access to your domain's DNS management panel
A .git account with an active subscription
Your project must be in a deployed state

Configuration Steps

Add Domain in Dashboard

Navigate to your project settings and locate the Domains section. Click Add Custom Domain and enter your desired domain or subdomain (e.g., app.yourdomain.com or yourdomain.com).

After entering the domain, click Save. The system will generate the required DNS records and switch to verification mode.

Configure DNS Records

Add the following records to your DNS provider's management panel. Do not modify existing records if you're using subdomains for other services.

Record Type	Host / Name	Value / Target	TTL
`CNAME`	`www` or subdomain	`cname.git.dev`	Auto (300s)
`A`	`@` (root domain)	`76.76.21.21`	Auto (300s)
`TXT`	`_git-verify.yourdomain`	`git-verify=abc123...`	Auto

⚠️

Root Domains: Most DNS providers don't support CNAME records at the apex (@). Use an A record pointing to 76.76.21.21 instead. If you use Cloudflare, enable CNAME Flattening or set proxy status to Proxied (Orange Cloud).

Verify & Wait for Propagation

Return to the .git dashboard and click Verify Now. Our system checks DNS resolution and validates the ownership TXT record.

DNS propagation typically takes 2-15 minutes. If verification fails, ensure:

No conflicting CNAME/A records exist
TTL is not set excessively high (>3600s)
Changes have been saved in your DNS provider

You can verify propagation manually:

Terminal

$ dig app.yourdomain.com +short
cname.git.dev.
$ nslookup _git-verify.yourdomain.com
Name: _git-verify.yourdomain.com
Address: 76.76.21.21
TXT record: "git-verify=abc123..."

SSL/TLS Provisioning

Once DNS verification passes, .git automatically provisions an SSL certificate via Let's Encrypt. This typically completes within 5-10 minutes.

Certificate status will update in the Domains dashboard
HTTPS is enforced by default (HTTP → HTTPS redirect enabled)
Certificates auto-renew 30 days before expiration

You can force HTTPS redirection in Project Settings > Security > Enforce HTTPS.

Troubleshooting

Domain stuck on "Pending Verification"

Check for typos in hostnames or values
Ensure no other services (e.g., WordPress, Wix, Shopify) are claiming the domain
Try flushing local DNS cache: ipconfig /flushdns (Windows) or sudo dscacheutil -flushcache (macOS)

SSL Certificate Fails to Issue

Verify ports 80 and 443 are open (not blocked by firewall/WAF)
Ensure the domain resolves correctly via public DNS tools
Contact your DNS provider if using a proxy service like Cloudflare (set to "DNS only" temporarily during verification)

Wildcard Domains

Use *.yourdomain.com to cover all subdomains. Note: Wildcards do not cover the root domain. You'll need a separate record for @.

Was this page helpful?