Setting your Operating System DNS

Once your operating system DNS is set - assuming you have your own resolver running - you'll be able to access Handshake domains trustlessly!


Regardless of operating system, once you have a Handshake resolver - either by spinning up a Docker instance, or compiling the resolver yourself - you'll need to point your DNS resolver to your local machine.

The address is the standard address for IPv4 loopback traffic. This is the DNS IP we'll be pointing our computer's Wi-Fi network service to.


Using the GUI

You can point your DNS settings to your local machine by navigating to System Preferences > Network > Advanced > DNS, and adding to your DNS provider list. Drag it to the top, and your browser will then utilize the light client running on your local machine to resolve Handshake domains.

Using the command line

To set your DNS Server from the command line, simply run

networksetup -setdnsservers Wi-Fi

Once set up, we recommend clearing your DNS servers of potentially previously cached domains to fully test whether the resolver is setup correctly.

To flush your DNS settings, run:sudo killall -HUP mDNSResponder

Windows 10

To update your DNS settings on Windows 10, follow the instructions below.

  1. Open Network and Internet settings in Control Panel.

  2. Select Change Adapter Settings.

  3. Right click your Network Adapter and select Properties.

  4. Select Internet Protocol Version 4 (TCP/IPv4) and then Properties.

  5. Toggle Use the following DNS server addresses and type in two DNS addresses (e.g., and

  6. Select OK when done.


Please refer to the following guide on setting your DNS settings on Linux, only you will point your DNS server to

Last updated


© 2022 Namebase, Inc