Setup Guide

Follow the instuctions below to set up CleanBrowsing on your device, browser or router.

CleanBrowsing for Routers

Only works on routers that can run executables

Our Help repository at CleanBrowsing Help provides specific instructions for different routers.


We use the Free Filtering service in the examples below. Paying customers should use the values issued in the dashboard.

Configuration Details
Recommended

IPv4

  • 1Log into your router. Access via links like http://192.168.0.1/ or http://192.168.1.1/ or App.
  • 2Locate the DNS settings inside the interface.
  • 3Remove all addresses (if any) then add 185.228.168.168 and 185.228.169.168
  • 4Click Save (or similar).
AND

IPv4 (Paying Customers)

  • 1Log into the CleanBrowsing Dashboard.
  • 2Click Your Network.
  • 3Add public IP to the Your Network card
  • 4Click Add IP Address or Domain Name.
AND

IPv6

If your network supports IPv6. Can also disable IPv6 on router and device.

  • 1Log into your router. Access via links like http://192.168.0.1/ or http://192.168.1.1/ or App.
  • 2Locate the DNS settings inside the interface.
  • 3Remove all addresses (if any) then add 2a0d:2a00:0001:0000:0000:0000:0000:0000 and 2a0d:2a00:0002:0000:0000:0000:0000:0000
  • 4Click Save (or similar).

CleanBrowsing for Windows

Only works on routers that can run executables

Our Help repository at CleanBrowsing Help provides specific instructions for different Windows configurations.


We use the Free Filtering service in the examples below. Paying customers should use the values issued in the dashboard.

Configuration Details
Recommended

DNS over HTTPS

Windows 11

  • 1Open the Settings app.
  • 2Go to Network & internet.
  • 3Click on Wi-Fi (or Ethernet).
  • 4Click on Hardware properties, or ignore this step if you clicked on Ethernet.
  • 5Click the Edit button next to DNS server assignment.
  • 6Select Manual.
  • 7Enable IPv4.
  • 8Enter 185.228.168.10 as Preferred DNS, then select On (manual template) and enter https://doh.cleanbrowsing.org/doh/custom-filter/[code].
  • 9Enter 185.228.168.168 as Alternate DNS, then select On (manual template) and enter https://doh.cleanbrowsing.org/doh/custom-filter/[code].
  • 10Click Save.
OR

IPv6

Your network supports IPv6

  • 1Click on the Start menu, then click on Control Panel.
  • 2Click on Network and Internet, then Network and Sharing Center.
  • 3Click on Change Adapter Settings.
  • 4Right click on the Wi-Fi network you are connected to, then click Properties.
  • 5Select Internet Protocol Version 6.
  • 6Click Properties.
  • 7Click Use The Following DNS Server Addresses.
  • 8Replace the current addresses (if any) with 2a0d:2a00:0001:0000:0000:0000:0000:0000 and 2a0d:2a00:0002:0000:0000:0000:0000:0000.
  • 9Click OK, then Close. You may need to restart your browser.
OR

Powershell

  • 1Click on the Search in toolbar.
  • 2Type PowerShell
  • 3Right-Click on Windows PowerShell and Run as Administrator
  • 9Copy and Paste the commands separately and press Enter inside the prompt window
Set-DnsClientServerAddress -InterfaceAlias "Ethernet" -ServerAddresses 185.228.168.168,185.228.169.168
AND
Set-DnsClientServerAddress -InterfaceAlias "Ethernet" -AddressFamily IPv6 -ServerAddresses 2a0d:2a00:1::,2a0d:2a00:2::
OR

Command Prompt

  • 1Click on the Search in toolbar.
  • 2Type Command
  • 3Right-Click on Command Prompt and Run as Administrator
  • 9Copy and Paste the commands separately and press Enter inside the prompt window
netsh interface ipv4 set dns name="Ethernet" static 185.228.168.168 & netsh interface ipv4 add dns name="Ethernet" 185.228.169.168 index=2
AND
netsh interface ipv6 set dnsservers "Ethernet" static 2a0d:2a00:1:: & netsh interface ipv6 add dnsservers "Ethernet" 2a0d:2a00:2:: index=2

CleanBrowsing for MacOS

Only works on routers that can run executables

Our Help repository at CleanBrowsing Help provides specific instructions for different MacOS configurations.


We use the Free Filtering service in the examples below. Paying customers should use the values issued in the dashboard.

Configuration Details
Recommended

Configuration Profile

macOS Big Sur or higher

  • 1Download the configuration profile.
  • 2Open Download folder
  • 3Doulbe-click mobile.config file
  • 4Click OK when it says Profile Downloaded
  • 5Open Settings app
  • 6Click Profile Downloaded in left menu
  • 7Double-click CleanBrowsing filter
  • 8Click Install on confirmation page
  • 9Click Install on second confirmation page
  • 10Entersystem password to install profile

Use our Apple Configuration Profile Generator available at cleanbrowsing.org

OR

CleanBrowsing for macOS

Download from Mac Store
  • 1Install our official app from the Mac App Store.
  • 2Click on Preferences in the app status bar menu and go to the Configuration tab.
  • 3Check "Use Custom Configuration" and enter 6d7872 as Configuration ID.
  • 4Enable NextDNS.
OR

Terminal

  • 1Click on the Search in top toolbar.
  • 2Type Terminal
  • 3Click on Terminal
  • 4Copy and Paste the command below and press Enter inside the terminal window
sudo networksetup -setdnsservers "Wi-Fi" 185.228.168.168 185.228.169.168 2a0d:2a00:1:: 2a0d:2a00:2::
AND

Terminal (PAYING CUSTOMERS)

Paying customers need to configure a scheduler so the system can track the public IP when using IPv4.

  • 1Click on the Search in top toolbar.
  • 2Type Terminal
  • 3Click on Terminal
  • 4Copy and Paste the command below and press Enter inside the terminal window
$ crontab -e
  • 5Copy and Paste the command below and press Enter inside the terminal window
*/10 * * * * /usr/bin/curl -fsS https://my.cleanbrowsing.org/dynip/MYCODE >/dev/null 2>&1

Update MYCODE with the code provided in your dashboard.

CleanBrowsing for Android

Only works on routers that can run executables

Our Help repository at CleanBrowsing Help provides specific instructions for different Android configurations.


We use the Free Filtering service in the examples below. Paying customers should use the values issued in the dashboard.

Configuration Details
Recommended

Configure Android using Private DNS

Android 9 or higher

  • 1Go to Settings → Network & internet → Advanced → Private DNS.
  • 2Select the Private DNS provider hostname option.
  • 3Enter custom[code].dot.cleanbrowsing.org and hit Save.

CleanBrowsing for iOS

Only works on routers that can run executables

Our Help repository at CleanBrowsing Help provides specific instructions for different iOS configurations.


We use the Free Filtering service in the examples below. Paying customers should use the values issued in the dashboard.

Configuration Details
Recommended

Configure the Apple iOS device using a configuration profile.

iOS 14 or higher

  • 1Download the configuration profile.
  • 2Save profile to Files (or preferred location)
  • 3Open Files, navigate to where you saved the profile.
  • 4Click on the downloaded profile (should read “profile downloaded“)
  • 5Click Close
  • 6Open the Settings app
  • 7Click Profile Downloaded
  • 8Click Install (top right)
  • 9Enter device code
  • 10Click Install
  • 11Click Done

Use our Apple Configuration Profile Generator steps available at cleanbrowsing.org

OR

CleanBrowsing for iOS

Download from App Store
  • 1Install our official app from the App Store.
  • 2Open the app.
  • 3Click Get Started.
  • 4Click Custom Filter, or Free Filters.
  • 5aIf, Custom Filter, enter code XXXXXX issued in paid dashboard.
  • 5bIf, Free Filters, Choose between Actviate Family, or Activate Adult.
  • 6Allow CleanBrowsing to add VPN configuration
Encrypted Info

Don't find what you're looking for? Drop us a line...

We love working with individuals and organizations to better understand what they need, and how we can help.

Get In Touch