Stefan Mogeritsch
aa157e82f8
- Documented Access Control features (e.g., Device Approvals, Password Rotation, 2FA, Custom Login Pages). - Added detailed descriptions for Logs & Analytics (Access Logs, Request Logs, Action Logs). - Included configuration instructions and feature-specific notes for Pangolin Cloud and Enterprise Edition. Signed-off-by: Stefan Mogeritsch <stefan.mo.co@gmail.com>
122 lines
4.0 KiB
Markdown
122 lines
4.0 KiB
Markdown
> ## Documentation Index
|
|
> Fetch the complete documentation index at: https://docs.pangolin.net/llms.txt
|
|
> Use this file to discover all available pages before exploring further.
|
|
|
|
# Domains
|
|
|
|
> Learn how to configure domains for your Pangolin resources and understand the different domain types available
|
|
|
|
<div id="pangolin-toc-cta" className="pangolin-toc-cta-source">
|
|
<Card title="Try free on Pangolin Cloud" icon="cloud" href="https://app.pangolin.net/auth/signup" arrow="true" cta="Sign up free">
|
|
Fastest way to get started with Pangolin using the hosted control plane. No credit card required.
|
|
</Card>
|
|
</div>
|
|
|
|
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)
|
|
|
|
<Tip>This is the most common type used for Self-Hosted</Tip>
|
|
|
|
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](/self-host/dns-and-networking).
|
|
|
|
### Domain Delegation (NS Records)
|
|
|
|
<Note>Cloud & [Enterprise Edition](/self-host/enterprise-edition) Only</Note>
|
|
|
|
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)
|
|
|
|
<Note>Cloud & [Enterprise Edition](/self-host/enterprise-edition) Only</Note>
|
|
|
|
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:**
|
|
|
|
```dns theme={null}
|
|
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
|
|
|
|
<Warning>
|
|
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.
|
|
</Warning>
|
|
|
|
When using domain delegation, you'll need to update your domain's nameservers:
|
|
|
|
**Example NS Records:**
|
|
|
|
```dns theme={null}
|
|
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:**
|
|
|
|
```dns theme={null}
|
|
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
|
|
```
|
|
|