Domains & SSL

Every Oblien deployment comes with a free subdomain and automatic SSL. Add custom domains to use your own brand.

Free Subdomain

All deployments automatically get a free subdomain:

your-project.obl.ee

Features:

• ✅ Automatic HTTPS/SSL
• ✅ No configuration required
• ✅ Instant activation
• ✅ Based on your project name

Subdomain Format

Your subdomain is generated from:

1. Your repository name (sanitized and lowercased)
2. Or your custom project name

Examples:

my-awesome-app.obl.ee
portfolio-site.obl.ee
api-backend.obl.ee

Custom Domains (Coming Soon)

Add your own domain name to your deployment.

Supported Configurations

• Apex Domain: example.com
• Subdomain: www.example.com or app.example.com
• Multiple Domains: Point multiple domains to one deployment

DNS Configuration

Step 1: Add Domain to Oblien

Navigate to your project's Domains tab and add your custom domain.

Step 2: Update DNS Records

Add these records at your DNS provider:

For Apex Domain (example.com):

Type: A
Name: @
Value: [Your deployment IP]

For Subdomain (www.example.com):

Type: CNAME
Name: www
Value: your-project.obl.ee

Step 3: Wait for Propagation

DNS changes can take 5 minutes to 48 hours to propagate globally.

Step 4: SSL Certificate

Oblien automatically provisions SSL certificates via Let's Encrypt once DNS is configured.

DNS Providers

Works with all major DNS providers:

• Cloudflare
• Google Domains
• Namecheap
• GoDaddy
• Route 53 (AWS)
• And any other DNS provider

SSL Certificates

Automatic SSL

All domains (free and custom) get automatic SSL certificates:

• ✅ Free SSL: No cost, automatically managed
• ✅ Auto-Renewal: Certificates auto-renew before expiration
• ✅ Let's Encrypt: Industry-standard certificates
• ✅ HTTPS Redirect: Automatic HTTP to HTTPS redirect

Certificate Details

• Provider: Let's Encrypt
• Validation: Automatic domain validation
• Renewal: Every 60 days (automatic)
• Coverage: All subdomains and custom domains

✅ Success: You don't need to do anything! SSL certificates are automatically provisioned and renewed.

Domain Management

View Domain Settings

Access domain configuration:

Dashboard → Projects → [Your Project] → Domains

Domain Status

Monitor your domain status:

• Active: Domain is live and serving traffic
• Pending: Waiting for DNS propagation
• Failed: DNS configuration issue
• SSL Pending: Certificate being provisioned

Domain Actions

Available actions for each domain:

• Set as Primary - Make this domain the primary URL for your project
• Remove Domain - Disconnect a custom domain from your project
• Renew SSL - Force SSL certificate renewal (usually automatic)
• View DNS - See required DNS configuration

Multiple Domains

Point multiple domains to the same deployment:

example.com        → your-app
www.example.com    → your-app
app.example.com    → your-app
your-app.obl.ee    → your-app

Use Cases

• WWW and Non-WWW: Serve both example.com and www.example.com
• Multiple Brands: Different domains for the same application
• Regional Domains: example.com, example.co.uk, example.de
• Development: staging.example.com, dev.example.com

Redirect Rules (Coming Soon)

Configure automatic redirects:

WWW Redirect

Redirect non-WWW to WWW (or vice versa):

example.com → www.example.com

HTTPS Redirect

Force HTTPS for all traffic (enabled by default):

http://example.com → https://example.com

Custom Redirects

Create custom redirect rules:

/old-page → /new-page
/blog/*   → /articles/*

Troubleshooting Domains

Domain Not Working

Check:

1. DNS records are correct
2. DNS has propagated (use nslookup or dig)
3. SSL certificate has been issued (can take 5-10 minutes)
4. No conflicting DNS records

Common Issues:

Verify DNS Propagation

Check if DNS has propagated:

# Check A record
nslookup example.com

# Check CNAME
dig www.example.com

# Check globally
https://www.whatsmydns.net

SSL Certificate Issues

If SSL isn't working:

1. Verify DNS: Certificate can't be issued until DNS points to Oblien
2. Check Status: View certificate status in Domains tab
3. Wait: Initial certificate can take 5-10 minutes
4. Manual Renewal: Click "Renew SSL" if needed

Best Practices

1. Use HTTPS Only

Always use HTTPS URLs:

✅ https://example.com
❌ http://example.com

2. Consistent Domain Usage

Choose one primary domain:

✅ www.example.com (redirect example.com here)
✅ example.com (redirect www here)
❌ Both without redirects

3. Update DNS Before Deploying

Configure DNS before going live to avoid downtime.

4. Monitor Certificate Expiry

Certificates auto-renew, but monitor status in your Domains tab.

5. Use Subdomains for Environments

Separate environments by subdomain:

app.example.com       → Production
staging.example.com   → Staging
dev.example.com       → Development

API Access (Coming Soon)

Manage domains programmatically:

// Add a domain
POST /api/domains
{
  "project_id": "xxx",
  "domain": "example.com"
}

// Remove a domain
DELETE /api/domains/:id

// Get DNS instructions
GET /api/domains/:id/dns

Security

SSL/TLS Configuration

All connections use modern security:

• TLS 1.2/1.3: Latest secure protocols
• Strong Ciphers: Only secure cipher suites
• HSTS: HTTP Strict Transport Security enabled
• Certificate Transparency: All certificates logged

DDoS Protection (Coming Soon)

Automatic protection against:

• Layer 7 attacks
• Rate limiting
• IP filtering
• Geographic blocking

Need Help?

• Check Troubleshooting for common domain issues
• See Quick Start for basic setup
• Review Configuration for advanced settings