Domains

Overview

The oblien domain command manages custom domains for your workspace — connect your own domain, inspect DNS readiness, and manage SSL state.

Commands

Get Domain

oblien domain get <ws-id>

Shows the current custom domain configuration, including the domain, port, SSL status, expiry, and any pending SSL error.

Check DNS

oblien domain check-dns <ws-id> --domain <domain>

Verifies DNS records are correctly configured before connecting. This is a dry-run — no changes are made.

Flag	Description
`--domain <domain>`	Domain to check (required)

Connect Domain

oblien domain connect <ws-id> --domain <domain> [--port <number>] [--include-www]

Connects a custom domain to the workspace. The route is registered immediately; SSL becomes active once the domain resolves to an approved edge target.

Flag	Description
`--domain <domain>`	Domain to connect (required, e.g. `app.example.com`)
`--port <number>`	Workspace port to route to (default: 3000)
`--include-www`	Also redirect `www.` to the domain

Disconnect Domain

oblien domain disconnect <ws-id>

Removes the custom domain, deletes routing rules, and clears the active SSL material from the edge.

Renew SSL

oblien domain renew-ssl <ws-id>

Force SSL certificate renewal. Certificates auto-renew, but you can trigger it manually.

DNS Setup

Before connecting, add these DNS records at your provider:

Type	Name	Value	Purpose
`CNAME`	`app`	`edge.oblien.com`	Route traffic to Oblien edge
`TXT`	`_oblien.app.example.com`	`verify=ws_a1b2c3d4`	Prove domain ownership

For root domains (no subdomain), use an A record pointing to 65.109.38.240 instead of CNAME.

For standard plans, the TXT record is required. Enterprise custom-domain grants can connect with edge DNS only and may use a branded TXT prefix instead of _oblien.

Examples

# Check DNS before connecting
oblien domain check-dns ws_abc123 --domain app.example.com

# Connect domain to port 3000
oblien domain connect ws_abc123 --domain app.example.com --port 3000

# Connect with www redirect
oblien domain connect ws_abc123 --domain example.com --include-www

# View current domain
oblien domain get ws_abc123

# Renew SSL certificate
oblien domain renew-ssl ws_abc123

# Remove domain
oblien domain disconnect ws_abc123

Workflow

A typical setup flow:

# 1. Add DNS records at your provider (CNAME + TXT)
# 2. Verify DNS is ready
oblien domain check-dns ws_abc123 --domain app.example.com

# 3. Connect (route is immediate, SSL may stay pending until edge DNS is ready)
oblien domain connect ws_abc123 --domain app.example.com --port 3000

# 4. Confirm
oblien domain get ws_abc123

See the Domains guide for full setup details and the API reference for programmatic access.

On this page