Skip to main content
Domains allow you to access your Pangolin resources through custom URLs. Pangolin supports different domain types depending on your deployment model and requirements.

​
Getting Started

In Pangolin Cloud, a domain is not required. You can use our provided domain endings like .hostlocal.app or .tunneled.to for your resources.

​
Domain Types

​
Wildcard (A Records)

This is the most common type used for Self-Hosted
Wildcard domains allow you to use any subdomain under a specified base domain or the domain itself.
  • Exact or Subdomains: Both the base domain and any subdomains work (e.g., example.com, app.example.com, db.example.com)
  • A Records: Uses A records pointing to Pangolin’s IP addresses
  • Simple: Just pointed to the IP of your server
More about self-hosted DNS and networking can be found in the DNS & Networking Section.

​
Domain Delegation (NS Records)

Cloud & Enterprise Only
Gives Pangolin full DNS control over your domain. Domain delegation is ideal when you want Pangolin to manage your entire domain and all its subdomains.
  • Full Domain Control: Includes the base domain and all subdomains
  • NS Records: Uses nameserver delegation for complete DNS management
  • Automatic Subdomains: All subdomains work automatically

​
Single Domain (CNAME Records)

Cloud & Enterprise Only
Single domain is limited to the exact domain you specify. CNAME domains are useful when your domain is already controlled by another provider but you still want to expose resources via Pangolin.
  • Exact Domain Only: Only the specific domain provided works
  • CNAME Records: Uses CNAME records pointing to Pangolin
  • No Subdomains: Subdomains will not work with CNAME domains
  • External DNS: Your domain remains controlled by your existing DNS provider

​
DNS Configuration

​
For Wildcard Domains

When using wildcard domains, you’ll need to add the following DNS records: Example Wildcard Records: 
Record 1: Type: A Name: *.example.com Value: 192.0.2.1  Record 2: Type: A Name: example.com Value: 192.0.2.1
You then access your resources via subdomains like app.example.com or db.example.com or example.com.

​
For Domain Delegation

Some domain providers, namely Cloudflare, do not allow adding NS records for the root of your domain. This would prevent you from delegating all *.example to Pangolin. However, you can usually delegate everything after the first level, like *.subdomain.example.com. If your provider restricts you in this way, you could either move your domain, or use CNAME records for individual subdomains of the root domain.
When using domain delegation, you’ll need to update your domain’s nameservers: Example NS Records: 
Type: NS Name: test.example.com Value: ns1.pangolin.net  ns2.pangolin.net  ns3.pangolin.net

​
For Single Domain (CNAME)

When using CNAME domains, you’ll need to add CNAME records: Example CNAME Records: 
Record 1: Type: CNAME Name: test.example.com Value: 0nbn5rpcq4wthq6.cname.pangolin.net  Record 2: Type: CNAME Name: _acme-challenge.test.example.com Value: _acme-challenge.0nbn5rpcq4wthq6.cname.pangolin.net