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.com
in 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
, ortunnel
instead - 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