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:
FieldValue
TypeCNAME
HostYour subdomain (e.g., tunnel, dev, api)
Points toYour Tunnelwise URL (e.g., your-tunnel.tunnelwise.io)
TTL1 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:

  1. Open Tunnelwise
  2. Start a tunnel with your custom domain
  3. Visit https://your-subdomain.yourdomain.com in your browser
  4. 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, or tunnel 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:

  1. Check the Tunnelwise Documentation
  2. Review existing and closed issues on Github. If you can't find a related issue, feel free to open one
  3. Visit GoDaddy's DNS Help Center