Custom Domains
Updated 2025-08-15
Configuring Custom Domains with GoDaddy
This guide will walk you through setting up a CNAME record in GoDaddy to use your custom domain with Tunnelwise.
Prerequisites
- A domain registered with GoDaddy
 - Your Tunnelwise unique URL (e.g., 
your-tunnel.tunnelwise.io) - Access to your GoDaddy account
 
Step-by-Step Instructions
1. Access Your GoDaddy Account
- Log in to your GoDaddy account
 - Navigate to My Products page
 - Find your domain and click DNS next to it
 
2. Navigate to DNS Management
- You'll be taken to the DNS Management page
 - Here you'll see all your existing DNS records in a table format
 - Look for the ADD button (usually in the bottom right)
 
3. Create a New CNAME Record
- Click the ADD button to create a new record
 - Configure the record with the following settings:
 
| Field | Value | 
|---|---|
| Type | CNAME | 
| Host | Your subdomain (e.g., tunnel, dev, api) | 
| Points to | Your Tunnelwise URL (e.g., your-tunnel.tunnelwise.io) | 
| TTL | 1 Hour (or use default) | 
Important: In the Host field, enter ONLY the subdomain part
- ✅ Correct: 
tunnel - ❌ Wrong: 
tunnel.yourdomain.com - ❌ Wrong: 
@(this represents the root domain) 
4. Save the Record
- Click Save or Add Record
 - You'll see a confirmation message
 - The new CNAME record will appear in your DNS records list immediately
 
Verification
DNS Propagation
GoDaddy DNS changes typically propagate within 1 hour, but can take up to 48 hours globally. You can check the propagation status using:
# Check if your CNAME is resolving correctly
dig your-subdomain.yourdomain.com CNAME
# Or using nslookup
nslookup your-subdomain.yourdomain.com
Testing Your Custom Domain
Once DNS has propagated:
- Open Tunnelwise
 - Start a tunnel with your custom domain
 - Visit 
https://your-subdomain.yourdomain.comin your browser - You should see your local application
 
Troubleshooting
Common Issues
1. "Record Already Exists" Error
Problem: GoDaddy says a record with that name already exists
Solution:
- Look for existing A, AAAA, or CNAME records with the same subdomain
 - Delete the old record first, then add your new CNAME
 - You cannot have both an A record and CNAME for the same subdomain
 
2. Root Domain Issues
Problem: Trying to use the root domain (yourdomain.com) instead of a subdomain
Solution:
- GoDaddy doesn't allow CNAME records for root domains
 - Use a subdomain like 
www,app, ortunnelinstead - Consider using domain forwarding if you need root domain support
 
GoDaddy-Specific Settings
DNS Record Limits
GoDaddy's DNS record limits by plan:
- Basic DNS: 500 total records
 - Premium DNS: 1000 total records
 - Ultimate DNS: 1500 total records
 
TTL Options
GoDaddy's available TTL values:
- 30 minutes
 - 1 hour (recommended)
 - 4 hours
 - 1 day
 - 1 week
 
Shorter TTL = faster updates but more DNS queries
Still Need Help?
If you encounter issues not covered in this guide:
- Check the Tunnelwise Documentation
 - Review existing and closed issues on Github. If you can't find a related issue, feel free to open one
 - Visit GoDaddy's DNS Help Center