Custom Domains

Connect your own domain to your published Omma projects.

Connect your own domain to any published Omma project. When visitors access your domain, they'll see your Omma project seamlessly.

Setup Process#

Publish your project

First, publish the project you want to connect a domain to.

Add your domain

Go to the project's publish settings and enter your custom domain (e.g., myproject.example.com).

Configure DNS

In your domain provider's DNS settings, add the record Omma shows you (each field has a copy button):

  • Subdomain (e.g. app.example.com) — a CNAME record pointing to cname.vercel-dns.com
  • Root domain (e.g. example.com) — an A record pointing to 216.150.1.1

See DNS Configuration below for the exact Name and Value in each case.

Verify

Omma will automatically verify the DNS configuration. This can take up to 48 hours for DNS propagation, but usually completes within minutes.

How It Works#

When a request comes in on a custom domain:

  1. The middleware detects the custom domain
  2. It looks up the domain in the published_projects table
  3. The request is internally rewritten to the project's public page
  4. The project is served seamlessly under your domain

DNS Configuration#

Subdomain (Recommended)#

For subdomains like docs.example.com, add a CNAME record:

text
Type:  CNAME
Name:  docs
Value: cname.vercel-dns.com

Root Domain#

For root domains like example.com, add an A record:

text
Type:  A
Name:  @
Value: 216.150.1.1

Domain verification (if prompted)#

If your domain is already connected to another service, Omma may also ask you to add a TXT record to prove ownership. When that's needed, the exact value is shown in your project's domain settings:

text
Type:  TXT
Name:  _vercel
Value: (the value Omma shows you)
Watch for conflicting records

Before adding the record, remove or update any existing A record (for a root domain) or CNAME record (for a subdomain) on the same name. A leftover record pointing somewhere else will stop your domain from connecting.

SSL/TLS#

Custom domains are served over HTTPS automatically. SSL certificates are provisioned and renewed through the hosting platform.

Requirements#

  • A published project on Omma
  • A paid plan (Pro or above)
  • Access to your domain's DNS settings
Previous
Credits & Billing
Next
Keyboard Shortcuts