How-To Guides
Add Custom Domain

Add Custom Domain

Use your own domain (like erp.yourcompany.com) instead of the default OEC.SH subdomain.

Plan Required: Pro or higher

Step 1: Get Your Server IP

  1. Open your environment
  2. Note the Server information
  3. Find the server's IP address in Servers section

Step 2: Configure DNS

At your domain registrar (GoDaddy, Cloudflare, Namecheap, etc.):

Option A: A Record (Recommended)

  1. Go to DNS settings for your domain
  2. Add an A record:
    • Host/Name: erp (or your subdomain)
    • Value: Your server's IP address
    • TTL: 300 (5 minutes)

Example: erp.yourcompany.com → 165.22.65.97

Option B: CNAME Record

  1. Add a CNAME record:
    • Host/Name: erp
    • Value: Your OEC.SH subdomain (e.g., myproject-prod-1234.apps.oec.sh)

Note: CNAME doesn't work for root domains (use A record for yourcompany.com).

Step 3: Add Domain in OEC.SH

  1. Open your environment
  2. Go to Settings → Domain
  3. In Custom Domain field, enter your domain:
    • erp.yourcompany.com
  4. Click Save
  5. Click Deploy to apply changes

Step 4: Wait for SSL

OEC.SH automatically provisions an SSL certificate via Let's Encrypt.

  1. After deployment, check the domain status
  2. SSL provisioning takes 1-5 minutes
  3. Once complete, your domain works with HTTPS

Verify It's Working

  1. Visit https://erp.yourcompany.com
  2. You should see your Odoo instance
  3. Check for the lock icon (🔒) in browser

Troubleshooting

"DNS not propagated yet"

DNS changes can take 5-30 minutes (sometimes up to 48 hours).

Check propagation: whatsmydns.net (opens in a new tab)

"SSL certificate failed"

Common causes:

  • DNS not pointing to correct IP
  • Domain has CAA records blocking Let's Encrypt
  • Rate limit hit (wait 1 hour and retry)

"Site not reachable"

  1. Verify DNS is pointing to correct server IP
  2. Check server firewall allows ports 80 and 443
  3. Ensure environment is running (🟢 status)

Using Multiple Domains

You can have both:

  • System subdomain: myproject-prod-1234.apps.oec.sh
  • Custom domain: erp.yourcompany.com

Both work simultaneously and point to the same environment.

Agency Domains (Enterprise)

If you're on an Enterprise plan with an agency domain configured:

  1. Go to Settings → Domain
  2. Enter your Agency Subdomain (e.g., clientname)
  3. Result: clientname.youragency.com

This lets you white-label deployments for clients.

What's Next?

Manage Your TeamScale Resources