Skip to main content
You can map up to 5 custom domains to each pod. SSL certificates are automatically provisioned via Let’s Encrypt.

Adding a Custom Domain

  1. Go to your pod’s Domains tab
  2. Click Add Domain
  3. Enter your domain (e.g., app.example.com)
  4. Choose a verification method:
Create a CNAME record pointing your domain to your pod’s default subdomain:
On Cloudflare, set the record’s proxy status to DNS only (grey cloud). A proxied record (orange cloud) answers with Cloudflare’s addresses and hides the CNAME, so verification cannot succeed. If you click Verify while the record is proxied, the dashboard tells you so.

TXT Verification

Add a TXT record to prove domain ownership:
The exact TXT record value is shown in the dashboard after adding the domain. TXT verification only proves ownership, so you still need a CNAME or A record pointing the domain at your pod.

Exact records for your DNS host

After you add a domain, the Domains tab looks up which company manages your domain’s DNS (Cloudflare, Namecheap, GoDaddy, Porkbun, Hostinger and others). It shows:
  • a link straight to that company’s DNS settings,
  • the records to create, with the Name written the way that DNS editor expects it (for app.example.com that is app, not the full domain),
  • notes specific to that host, such as turning off Cloudflare’s proxy.
For a root domain like example.com, the record depends on your DNS host. Cloudflare and Namecheap take a CNAME at @. Porkbun and some others offer an ALIAS or ANAME record. If your DNS host refuses that record, the dashboard also offers an A record pointing at your pod’s server: add one or the other, not both. On hosts that take neither a CNAME nor an ALIAS at the root, such as GoDaddy, the A record is the only option. An A record has to change if your pod is ever moved to another server, so where you have the choice, the CNAME (or a www subdomain with a CNAME) is the sturdier option.

Connect automatically

If your DNS host supports Domain Connect for InstaPods, you’ll see a Connect automatically button. You sign in to your DNS host, approve one record, and come straight back. The domain is checked the moment you return. This works for subdomains.

Verifying

You don’t have to click anything. InstaPods checks pending domains every minute for the first half hour, then less often for up to two weeks. As soon as the record is in place it issues the certificate and switches the domain on. Leave the Domains tab open and it updates by itself. You can still click Check DNS to check right away. InstaPods asks your domain’s own nameservers, so a record you just added is seen immediately, even if DNS caches elsewhere haven’t caught up.

SSL Certificates

Once verified, an SSL certificate is automatically issued via Let’s Encrypt using certbot. The certificate covers your custom domain and enables HTTPS access. Certificates auto-renew before expiration — no action needed.

Removing a Domain

Click the delete icon next to any domain to remove the mapping. This also removes the nginx configuration and SSL certificate from the server.

From the CLI

The same flow is available in the terminal:
See the CLI reference for all commands.

Limits

  • Maximum 5 custom domains per pod
  • Domains must be unique across the platform
  • Subdomains work (e.g., staging.example.com). Root domains work too: see Exact records for your DNS host