Domain & SSL Issues

Troubleshoot custom domain configuration, DNS problems, and SSL certificate issues in OEC.sh.

SSL Certificate Errors

Symptom

Browser shows "connection not secure" or SSL certificate warnings.

Common Causes and Solutions

Certificate Not Yet Issued

Symptom: SSL error immediately after adding a custom domain.

Solution:

1. SSL certificates take 1-5 minutes to issue
2. Check domain status: Environment → Domains
3. Verify DNS is properly configured
4. Wait and refresh the page

DNS Not Pointing to Server

Symptom: "DNS validation failed" or certificate won't issue.

Solution:

1. Verify DNS records are correct
2. Use DNS lookup tools to confirm propagation
3. Wait for DNS propagation (can take up to 48 hours)

# Check A record
dig +short yourdomain.com A
 
# Check CNAME record
dig +short www.yourdomain.com CNAME
 
# Online tool: dnschecker.org

Certificate Renewal Failed

Symptom: SSL worked before but now shows expired certificate.

Solution:

1. Check domain configuration hasn't changed
2. Verify DNS still points to correct server
3. Force certificate renewal: Environment → Domains → Refresh SSL

Mixed Content Warnings

Symptom: Page loads but browser shows "partially secure" warning.

Solution:

1. Check Odoo's web.base.url setting
2. Go to Settings → System Parameters in Odoo
3. Set web.base.url to https://yourdomain.com
4. Check for hardcoded HTTP links in customizations

DNS Issues

Symptom

Domain doesn't resolve or points to wrong server.

Common Causes and Solutions

DNS Not Propagated

Symptom: DNS changes not taking effect.

Solution:

1. DNS propagation can take 1-48 hours
2. Use multiple DNS checkers to verify global propagation
3. Try flushing local DNS cache:

# macOS
sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
 
# Windows
ipconfig /flushdns
 
# Linux
sudo systemd-resolve --flush-caches

Incorrect DNS Records

Symptom: Domain resolves to wrong IP or doesn't resolve.

# Verify A record
dig yourdomain.com +short
 
# Should return your server's IP address

Conflicting DNS Records

Symptom: Inconsistent behavior, sometimes works, sometimes doesn't.

Solution:

1. Check for duplicate A records
2. Remove conflicting CNAME records
3. Verify there's no CDN or proxy interfering

Mixed Content Warnings

Symptom

HTTPS page loads but some resources are blocked or show warnings.

Common Causes and Solutions

Odoo Base URL Misconfigured

Symptom: Links in emails or UI use HTTP instead of HTTPS.

Solution:

1. Access Odoo backend
2. Go to Settings → System Parameters
3. Update web.base.url to https://yourdomain.com
4. Update web.base.url.freeze to True

Custom Module Using HTTP

Symptom: Specific features show mixed content warnings.

Solution:

1. Search custom module code for http:// URLs
2. Replace with https:// or use protocol-relative URLs (//)
3. Check for hardcoded asset URLs

External Resources

Symptom: Third-party widgets or integrations cause warnings.

Solution:

1. Identify which external resources are loaded via HTTP
2. Use browser developer tools: Network tab → filter by HTTP
3. Update integrations to use HTTPS endpoints

Custom Domain Configuration

Adding a Custom Domain

Type: CNAME
Name: erp
Value: my-project-production.apps.oec.sh
TTL: 300

Type: A
Name: @
Value: [Your Server IP from Environment settings]
TTL: 300

Multiple Domains

You can add multiple domains to a single environment:

• Primary domain (used for Odoo's web.base.url and email links)
• Additional domains (also route to the same environment)

Domain with Cloudflare

If using Cloudflare:

DNS Provider Integration

Available on Pro and Agency plans

OEC.sh can manage DNS records automatically for supported providers:

• Cloudflare
• AWS Route53
• Azure DNS
• Google Cloud DNS
• DigitalOcean
• Hetzner DNS

Setup DNS Provider

1. Go to Settings → DNS Providers
2. Click Add Provider
3. Select your provider and enter credentials
4. Test the connection

Automatic DNS Management

Once configured, OEC.sh can:

• Automatically create DNS records for new domains
• Update records when server IPs change
• Clean up records when domains are removed

Troubleshooting Checklist

Domain Not Working

• DNS records are correct
• DNS has propagated (check multiple locations)
• No conflicting records exist
• Domain status shows "Active" in OEC.sh

SSL Not Working

• Domain resolves correctly
• Certificate status shows "Issued"
• No firewall blocking port 443
• web.base.url uses HTTPS

Intermittent Issues

• Check for DNS caching
• Verify no CDN/proxy interference
• Test from multiple networks
• Check server health

Common DNS Configurations

Subdomain Pointing to System URL (Recommended)

# Point subdomain to your environment's system URL
Type: CNAME
Name: erp
Value: my-project-production.apps.oec.sh

This is the easiest setup. If your server IP ever changes, the CNAME follows automatically.

Root Domain + WWW

# Root domain (CNAME not allowed, must use A record)
Type: A
Name: @
Value: [Server IP]

# WWW subdomain (CNAME to system URL)
Type: CNAME
Name: www
Value: my-project-production.apps.oec.sh

Root Domain with A Record

# When you need to use the apex domain directly
Type: A
Name: @
Value: [Server IP from Environment settings]

Still Having Issues?

If the above solutions don't resolve your problem:

1. Collect Information:

   • Domain name
   • Current DNS configuration
   • Error messages
   • Browser and version

2. Contact Support: Email support@oec.sh