Omaship
Documentation Menu ▼

DNS Setup

DNS configuration is the only manual step. Here's exactly what records you need.

Required Records

Add these records at your domain registrar (GoDaddy, Namecheap, Cloudflare, etc.):

Type Name Value Purpose
A @ [Your server IP] Main domain
A www [Your server IP] www subdomain
CNAME *.preview yourdomain.com PR previews

Your server IP is shown in your Omaship dashboard after creating your app.

Provider-Specific Guides

Cloudflare

  1. Go to DNS → Records
  2. Add A record: Name @, IPv4 [your IP], Proxy status: DNS only
  3. Add A record: Name www, IPv4 [your IP], Proxy status: DNS only
  4. Add CNAME: Name *.preview, Target yourdomain.com

Important: Set proxy status to "DNS only" (gray cloud). Orange cloud breaks SSL.

Namecheap

  1. Go to Domain List → Manage → Advanced DNS
  2. Add A record: Host @, Value [your IP]
  3. Add A record: Host www, Value [your IP]
  4. Add CNAME: Host *.preview, Value yourdomain.com. (note the trailing dot)

GoDaddy

  1. Go to My Products → DNS
  2. Add A record: Name @, Value [your IP]
  3. Add A record: Name www, Value [your IP]
  4. Add CNAME: Name *.preview, Value @

Propagation Time

DNS changes typically take 5-30 minutes to propagate. You can check status at:

Troubleshooting

Site not loading after DNS change

  • Wait 30 minutes for propagation
  • Clear browser cache or try incognito mode
  • Verify records at dnschecker.org

SSL certificate errors

  • If using Cloudflare, ensure proxy is disabled (gray cloud)
  • SSL certificates are issued automatically—give it 5 minutes after DNS propagates

Preview deployments not working

  • Verify the wildcard CNAME *.preview is set correctly
  • Some registrars don't support wildcard CNAMEs—check your provider's docs