Merge pull request #341 from AdguardTeam/agm-2602-add-custom-domains-section

[AGM-2602] Add info about Custom domains

Author: vyanovsky

docs/private-dns/api/_category_.json

@@ -1,6 +1,6 @@
 {
-    "position": 6,
+    "position": 7,
     "label": "API",
     "collapsible": true,
     "collapsed": true
-}
+}

docs/private-dns/custom-domains.md

@@ -0,0 +1,31 @@
+---
+title: Custom domains
+sidebar_position: 6
+---
+
+AdGuard DNS subscribers can set up their own domains (like `dns.example.com`) instead of the default `d.adguard-dns.com`. This feature is intended to help businesses align DNS protection with their infrastructure by ensuring seamless integration with corporate security policies while maintaining full ad-blocking and privacy features provided by AdGuard DNS.
+
+:::note
+
+Custom domains are available to the users of **Enterprise** and **Team** plans.
+
+:::
+
+## How to set up a custom domain
+
+To configure a custom domain, log in to your AdGuard DNS dashboard and go to [*Account settings*](https://adguard-dns.io/en/dashboard/account). Scroll down to *Advanced settings* and select *Custom domains*. Next, you will need to go through the three main steps.
+
+1. Choose the protocol. Here, you have two options:
+
+    - Add DoH domain (for DNS-over-HTTPS)
+    - Add DoT/DoQ domain (for DNS-over-TLS or DNS-over-QUIC)
+
+    ![Choose the protocol *mobile](https://cdn.adtidy.org/content/release_notes/dns/v2-15/picture_en_1.png)
+
+1. After selecting the protocol, enter the preferred domain name (e.g., `example.com`) and verify the CNAME record.
+
+    ![CNAME record *mobile](https://cdn.adtidy.org/content/release_notes/dns/v2-15/picture_en_2.png)
+
+1. Set up a certificate. For DoT/DoQ domains, you’ll need to upload a wildcard TLS certificate. If you choose DoH, you can either provide your own TLS certificate or let AdGuard DNS generate one for you. Once verified, your custom domain will appear in the dashboard, ready for use.
+
+    ![Custom domain list *mobile](https://cdn.adtidy.org/content/release_notes/dns/v2-15/picture_en_3.png)

docs/private-dns/overview.md

@@ -213,3 +213,9 @@ In this section we describe a number of settings that allow you to fine-tune the
 Statistics and Query log provide insight into the activity of your devices. The *Statistics* tab allows you to view a summary of DNS requests made by devices connected to your Private AdGuard DNS. In the Query log, you can view information about each request and also sort requests by status, type, company, device, time, and country.
 
 [Statistics and Query log](/private-dns/statistics-and-log/statistics.md)
+
+### Custom domains
+
+AdGuard DNS Enterprise and Team subscribers can use their own domains (like `dns.example.com`) instead of the default `d.adguard-dns.com`. This setting ensures seamless integration with corporate security policies while maintaining full ad-blocking and privacy features provided by AdGuard DNS.
+
+[Custom domains](/private-dns/custom-domains.md)

docs/private-dns/solving-problems/_category_.json

@@ -1,6 +1,6 @@
 {
-    "position": 7,
+    "position": 8,
     "label": "Solving problems",
     "collapsible": true,
     "collapsed": true
-}
+}