AdguardTeam · SeverAnna · Oct 7, 2024 · Sep 18, 2024 · Sep 18, 2024 · Sep 18, 2024
diff --git a/docs/private-dns/api/_category_.json b/docs/private-dns/api/_category_.json
@@ -1,5 +1,5 @@
 {
-    "position": 2,
+    "position": 6,
     "label": "API",
     "collapsible": true,
     "collapsed": true

diff --git a/docs/private-dns/connect-devices/_category_.json b/docs/private-dns/connect-devices/_category_.json
@@ -0,0 +1,6 @@
+{
+    "position": 2,
+    "label": "How to connect devices",
+    "collapsible": true,
+    "collapsed": true
+}
diff --git a/docs/private-dns/connect-devices/connect-devices.md b/docs/private-dns/connect-devices/connect-devices.md
@@ -0,0 +1,26 @@
+---
+title: General information
+sidebar_position: 1
+toc_min_heading_level: 2
+toc_max_heading_level: 3
+---
+
+In this section you will find instructions on how to connect your device to AdGuard DNS and learn about the main features of the service.
+
+- [Android](/private-dns/connect-devices/mobile-and-desktop/android.md)
+- [iOS](/private-dns/connect-devices/mobile-and-desktop/ios.md)
+- [MacOS](/private-dns/connect-devices/mobile-and-desktop/macos.md)
+- [Windows](/private-dns/connect-devices/mobile-and-desktop/windows.md)
+- [Linux](/private-dns/connect-devices/mobile-and-desktop/linux.md)
+- [Routers](/private-dns/connect-devices/routers/routers.md)
+- [Gaming consoles](/private-dns/connect-devices/gaming-consoles/gaming-consoles.md)
+
+For devices that do not natively support encrypted DNS protocols, we offer three other options:
+
+- [AdGuard DNS Client](/private-dns/connect-devices/other-options/client.md)
+- [Dedicated IPs](/private-dns/connect-devices/other-options/dedicated-ip.md)
+- [Linked IPs](/private-dns/connect-devices/other-options/linked-ip.md)
+
+If you want to restrict access to AdGuard DNS to certain devices, use [DNS-over-HTTPS with authentication](/private-dns/connect-devices/other-options/doh-authentication.md).
+
+For connecting a large number of devices, there is an [automatic connection option](/private-dns/connect-devices/other-options/automatic-connection.md).
diff --git a/docs/private-dns/connect-devices/gaming-consoles/_category_.json b/docs/private-dns/connect-devices/gaming-consoles/_category_.json
@@ -0,0 +1,6 @@
+{
+    "position": 3,
+    "label": "Gaming consoles",
+    "collapsible": true,
+    "collapsed": true
+}
diff --git a/docs/private-dns/connect-devices/gaming-consoles/gaming-consoles.md b/docs/private-dns/connect-devices/gaming-consoles/gaming-consoles.md
@@ -0,0 +1,12 @@
+---
+title: Gaming consoles
+sidebar_position: 1
+---
+
+Gaming consoles do not support encrypted DNS, but they are well suited for setting up a public AdGuard DNS or a private AdGuard DNS via linked IP address.
+
+- [Nintendo](private-dns/connect-devices/gaming-consoles/nintendo.md)
+- [Nintendo Switch](private-dns/connect-devices/gaming-consoles/nintendo-switch.md)
+- [PlayStation](private-dns/connect-devices/gaming-consoles/playstation.md)
+- [Steam Deck](/private-dns/connect-devices/gaming-consoles/steam.md)
+- [Xbox One](private-dns/connect-devices/gaming-consoles/xbox-one.md)
diff --git a/docs/private-dns/connect-devices/gaming-consoles/nintendo-switch.md b/docs/private-dns/connect-devices/gaming-consoles/nintendo-switch.md
@@ -0,0 +1,35 @@
+---
+title: Nintendo Switch
+sidebar_position: 3
+---
+
+It is likely that your router supports the use of encrypted DNS servers, so you can always configure Private AdGuard DNS on it and connect your game console to it.
+
+You can find instructions on how to configure your router in [this section](/private-dns/connect-devices/routers/routers.md).
+
+## Connect AdGuard DNS
+
+Configure your game console to use a public AdGuard DNS server or configure it via linked IP:
+
+1. Turn on your Nintendo Switch console and go to the Home Menu.
+
+1. Go to System Settings → Internet.
+
+1. Select the Wi-Fi network that you want to modify the DNS settings for.
+
+1. Click Change Settings for the selected Wi-Fi network.
+
+1. Scroll down and select DNS Settings.
+
+1. In the DNS Server field, enter one of the following DNS server addresses:
+
+    94.140.14.49
+
+    94.140.14.59
+
+1. Save your DNS settings.
+
+It would be preferable to use Linked IP (Or link your Dedicated IP if you're using a team subscription)
+
+- [Dedicated IPs](/private-dns/connect-devices/other-options/dedicated-ip.md)
+- [Linked IPs](/private-dns/connect-devices/other-options/linked-ip.md)
diff --git a/docs/private-dns/connect-devices/gaming-consoles/nintendo.md b/docs/private-dns/connect-devices/gaming-consoles/nintendo.md
@@ -0,0 +1,39 @@
+---
+title: Nintendo
+sidebar_position: 2
+---
+
+It is likely that your router supports the use of encrypted DNS servers, so you can always configure Private AdGuard DNS on it and connect your game console to it.
+
+You can find instructions on how to configure your router in [this section](/private-dns/connect-devices/routers/routers.md).
+
+> Applies to: New Nintendo 3DS, New Nintendo 3DS XL, New Nintendo 2DS XL, Nintendo 3DS, Nintendo 3DS XL, and Nintendo 2DS.
+
+## Connect AdGuard DNS
+
+Configure your game console to use a public AdGuard DNS server or configure it via linked IP:
+
+1. From the Home menu, select System Settings.
+
+1. Go to Internet Settings → Connection Settings.
+
+1. Select the connection file, then select Change Settings.
+
+1. Select DNS, then select Set Up.
+
+1. Set Auto-Obtain DNS to No.
+
+1. Select Detailed Setup, then Primary DNS. Hold down the left arrow to delete the existing DNS.
+
+1. In the DNS Server field, enter one of the following DNS server addresses:
+
+    94.140.14.49
+
+    94.140.14.59
+
+1. Save the settings.
+
+It would be preferable to use Linked IP (Or link your Dedicated IP if you're using a team subscription)
+
+- [Dedicated IPs](/private-dns/connect-devices/other-options/dedicated-ip.md)
+- [Linked IPs](/private-dns/connect-devices/other-options/linked-ip.md)
diff --git a/docs/private-dns/connect-devices/gaming-consoles/playstation.md b/docs/private-dns/connect-devices/gaming-consoles/playstation.md
@@ -0,0 +1,49 @@
+---
+title: PlayStation PS4/PS5
+sidebar_position: 4
+---
+
+It is likely that your router supports the use of encrypted DNS servers, so you can always configure Private AdGuard DNS on it and connect your game console to it.
+
+You can find instructions on how to configure your router in [this section](/private-dns/connect-devices/routers/routers.md).
+
+## Connect AdGuard DNS
+
+Configure your game console to use a public AdGuard DNS server or configure it via linked IP:
+
+1. Turn on your PS4/PS5 console and sign in to your account.
+
+1. From the home screen, select the gear icon located in the top row.
+
+1. In the Settings menu, select Network.
+
+1. Select Set Up Internet Connection.
+
+1. Choose Use Wi-Fi or Use a LAN Cable, depending on your network setup.
+
+1. Select Custom and then select Automatic for IP Address Settings.
+
+1. For DHCP Host Name, select Do Not Specify.
+
+1. For DNS Settings, select Manual.
+
+1. In the DNS Server field, enter one of the following DNS server addresses:
+
+    94.140.14.49
+
+    94.140.14.59
+
+1. Select Next to continue.
+
+1. On the MTU Settings screen, select Automatic.
+
+1. On the Proxy Server screen, select Do Not Use.
+
+1. Select Test Internet Connection to test your new DNS settings.
+
+1. Once the test is complete and you see Internet Connection: Successful, save your settings.
+
+It would be preferable to use Linked IP (Or link your Dedicated IP if you're using a team subscription)
+
+- [Dedicated IPs](/private-dns/connect-devices/other-options/dedicated-ip.md)
+- [Linked IPs](/private-dns/connect-devices/other-options/linked-ip.md)
diff --git a/docs/private-dns/connect-devices/gaming-consoles/steam.md b/docs/private-dns/connect-devices/gaming-consoles/steam.md
@@ -0,0 +1,35 @@
+---
+title: Steam Deck
+sidebar_position: 5
+---
+
+It is likely that your router supports the use of encrypted DNS servers, so you can always configure Private AdGuard DNS on it and connect your game console to it.
+
+You can find instructions on how to configure your router in [this section](/private-dns/connect-devices/routers/routers.md).
+
+## Connect AdGuard DNS
+
+Configure your game console to use a public AdGuard DNS server or configure it via linked IP:
+
+1. Open the Steam Deck settings by clicking the gear icon in the upper right corner of the screen.
+
+1. Click Network.
+
+1. Click the gear icon next to the network connection you want to configure.
+
+1. Select IPv4 or IPv6, depending on the type of network you're using.
+
+1. Select Automatic (DHCP) addresses only or Automatic (DHCP).
+
+1. In the DNS Server field, enter one of the following DNS server addresses:
+
+    94.140.14.49
+
+    94.140.14.59
+
+1. Save the changes.
+
+It would be preferable to use Linked IP (Or link your Dedicated IP if you're using a team subscription)
+
+- [Dedicated IPs](/private-dns/connect-devices/other-options/dedicated-ip.md)
+- [Linked IPs](/private-dns/connect-devices/other-options/linked-ip.md)
diff --git a/docs/private-dns/connect-devices/gaming-consoles/xbox-one.md b/docs/private-dns/connect-devices/gaming-consoles/xbox-one.md
@@ -0,0 +1,35 @@
+---
+title: Xbox One
+sidebar_position: 6
+---
+
+It is likely that your router supports the use of encrypted DNS servers, so you can always configure Private AdGuard DNS on it and connect your game console to it.
+
+You can find instructions on how to configure your router in [this section](/private-dns/connect-devices/routers/routers.md).
+
+## Connect AdGuard DNS
+
+Configure your game console to use a public AdGuard DNS server or configure it via linked IP:
+
+1. Turn on your Xbox One console and sign in to your account.
+
+1. Press the Xbox button on your controller to open the guide, and then select System from the menu.
+
+1. In the Settings menu, select Network.
+
+1. Under Network settings, select Advanced settings.
+
+1. Under DNS settings, select Manual.
+
+1. In the DNS Server field, enter one of the following DNS server addresses:
+
+    94.140.14.49
+
+    94.140.14.59
+
+1. Save the changes.
+
+It would be preferable to use Linked IP (Or link your Dedicated IP if you're using a team subscription)
+
+- [Dedicated IPs](/private-dns/connect-devices/other-options/dedicated-ip.md)
+- [Linked IPs](/private-dns/connect-devices/other-options/linked-ip.md)
diff --git a/docs/private-dns/connect-devices/mobile-and-desktop/_category_.json b/docs/private-dns/connect-devices/mobile-and-desktop/_category_.json
@@ -0,0 +1,6 @@
+{
+    "position": 1,
+    "label": "Mobile and desktop",
+    "collapsible": true,
+    "collapsed": true
+}
diff --git a/docs/private-dns/connect-devices/mobile-and-desktop/android.md b/docs/private-dns/connect-devices/mobile-and-desktop/android.md
@@ -0,0 +1,23 @@
+---
+title: Android
+sidebar_position: 2
+---
+
+To connect an Android device to AdGuard DNS, first add it to Dashboard:
+
+1. smth
+1. smth
+1. smth
+
+## Use AdGuard Ad Blocker (paid option)
+
+## Use AdGuard VPN
+
+## Configure Private DNS manually
+
+## Configure plain DNS
+
+If you prefer not to use extra software for DNS configuration, you can opt for unencrypted DNS. You have two choices: using linked IPs or dedicated IPs.
+
+- [Dedicated IPs](/private-dns/connect-devices/other-options/dedicated-ip.md)
+- [Linked IPs](/private-dns/connect-devices/other-options/linked-ip.md)
diff --git a/docs/private-dns/connect-devices/mobile-and-desktop/ios.md b/docs/private-dns/connect-devices/mobile-and-desktop/ios.md
@@ -0,0 +1,23 @@
+---
+title: iOS
+sidebar_position: 3
+---
+
+To connect an iOs device to AdGuard DNS, first add it to Dashboard:
+
+1. smth
+1. smth
+1. smth
+
+## Use AdGuard Ad Blocker (paid option)
+
+## Use AdGuard VPN
+
+## Configure Private DNS manually
+
+## Configure plain DNS
+
+If you prefer not to use extra software for DNS configuration, you can opt for unencrypted DNS. You have two choices: using linked IPs or dedicated IPs.
+
+- [Dedicated IPs](/private-dns/connect-devices/other-options/dedicated-ip.md)
+- [Linked IPs](/private-dns/connect-devices/other-options/linked-ip.md)
diff --git a/docs/private-dns/connect-devices/mobile-and-desktop/linux.md b/docs/private-dns/connect-devices/mobile-and-desktop/linux.md
@@ -0,0 +1,29 @@
+---
+title: Linux
+sidebar_position: 6
+---
+
+To connect a Linux device to AdGuard DNS, first add it to Dashboard:
+
+1. smth
+1. smth
+1. smth
+
+## Use AdGuard DNS Client
+
+AdGuard DNS Client is really great, [learn more about it](/dns-client/overview).
+
+## Use AdGuard VPN CLI
+
+## Configure manually on Ubuntu (Linked IP или Dedicated IP required)
+
+## Configure manually on Debian (Linked IP или Dedicated IP required)
+
+## Use dnsmasq
+
+## Use plain DNS
+
+If you prefer not to use extra software for DNS configuration, you can opt for unencrypted DNS. You have two choices: using linked IPs or dedicated IPs.
+
+- [Dedicated IPs](/private-dns/connect-devices/other-options/dedicated-ip.md)
+- [Linked IPs](/private-dns/connect-devices/other-options/linked-ip.md)
diff --git a/docs/private-dns/connect-devices/mobile-and-desktop/macos.md b/docs/private-dns/connect-devices/mobile-and-desktop/macos.md
@@ -0,0 +1,23 @@
+---
+title: macOS
+sidebar_position: 4
+---
+
+To connect a macOS device to AdGuard DNS, first add it to Dashboard:
+
+1. smth
+1. smth
+1. smth
+
+## Use AdGuard Ad Blocker (paid option)
+
+## Use AdGuard VPN
+
+## Configure Private DNS manually
+
+## Configure plain DNS
+
+If you prefer not to use extra software for DNS configuration, you can opt for unencrypted DNS. You have two choices: using linked IPs or dedicated IPs.
+
+- [Dedicated IPs](/private-dns/connect-devices/other-options/dedicated-ip.md)
+- [Linked IPs](/private-dns/connect-devices/other-options/linked-ip.md)
diff --git a/docs/private-dns/connect-devices/mobile-and-desktop/windows.md b/docs/private-dns/connect-devices/mobile-and-desktop/windows.md
@@ -0,0 +1,23 @@
+---
+title: Windows
+sidebar_position: 5
+---
+
+To connect a Windows device to AdGuard DNS, first add it to Dashboard:
+
+1. smth
+1. smth
+1. smth
+
+## Use AdGuard Ad Blocker (paid option)
+
+## Use AdGuard VPN
+
+## Configure Private DNS manually
+
+## Configure plain DNS
+
+If you prefer not to use extra software for DNS configuration, you can opt for unencrypted DNS. You have two choices: using linked IPs or dedicated IPs.
+
+- [Dedicated IPs](/private-dns/connect-devices/other-options/dedicated-ip.md)
+- [Linked IPs](/private-dns/connect-devices/other-options/linked-ip.md)