diff --git a/manage/domains.mdx b/manage/domains.mdx index 72e2da0..0798641 100644 --- a/manage/domains.mdx +++ b/manage/domains.mdx @@ -11,87 +11,65 @@ In Pangolin Cloud, a domain is not required. You can use our provided domain end ## Domain Types - -SSL certificates are automatically acquired and managed for both CNAME and NS domain types. No additional certificate configuration is required. - +### 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](/self-host/dns-and-networking). ### Domain Delegation (NS Records) -Domain delegation gives Pangolin full DNS control over your domain: +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 - -Domain delegation is ideal when you want Pangolin to manage your entire domain and all its subdomains. - - ### Single Domain (CNAME Records) -Single domain is limited to the exact domain you specify: +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 - -CNAME domains are useful when your domain is already controlled by another provider but you still want to expose resources via Pangolin. - - -## Adding Domains - -### Pangolin Cloud - -Domains can be added to an organization via the domains section of the organization settings: - - - - Go to your organization settings and select the "Domains" section. - - - - Select either "Domain Delegation" or "Single Domain" based on your needs. - - - - Provide your domain name (e.g., example.com). - - - - Follow the provided instructions to add the required DNS records to your provider. - - - - DNS changes may take time to propagate. The domain will show as verified once propagation is complete. - - - - -Domain delegation and CNAME domains are only available in Pangolin Cloud. Community Edition Pangolin uses different domain configuration methods. - - -### Self-Hosted Pangolin - -For self-hosted Pangolin, domains are configured differently, though you can still create domains in the UI. - - - - Configure domains via the config file, including certificate resolver settings. - - - - Set up wildcard domains for flexible subdomain management. - - - - -In self-hosted Pangolin, domains do not need individual verification, but you're responsible for ensuring correct DNS records point to your server. - - ## DNS Configuration +### For Wildcard Domains + +When using wildcard domains, you'll need to add the following DNS records: + +**Example Wildcard Records:** + +```dns +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 When using domain delegation, you'll need to update your domain's nameservers: