Namebase Learning Center
HomeHelp & Support
English
English
  • Introduction
  • How to
    • Use Handshake names
    • Create Handshake websites
    • Handshake DNS
    • Access Handshake names
    • Get Handshake names
    • Buy Handshake coins (HNS)
    • Transferring HNS & Names
  • Handshake
    • About Handshake
    • Name minting auction
    • HNS coin economics
  • Namebase
    • Vision and mission
    • Private naming
    • Verifying
    • Security
    • Revenue streams
  • Development
    • Developer Guides
      • Traditional website
      • Decentralized website
      • Decentralized blog
      • Decentralized login
        • Handshake-based OIDC Authentication Protocol
        • Using Handshake Login
        • Handshake Login Implementation Guide
    • Resolving Handshake
      • HNS.to
      • HNSDoH
      • Resolving Handshake locally
        • Setting up the light client
        • Setting your Operating System DNS
    • Namebase Record Assistant
Powered by GitBook
LogoLogo

Connect

  • Twitter
  • Discord
  • Github

© 2022 Namebase, Inc

On this page
  • Overview
  • OSX
  • Using the GUI
  • Using the command line
  • Windows 10
  • Linux

Was this helpful?

Edit on GitHub
  1. Development
  2. Resolving Handshake
  3. Resolving Handshake locally

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!

Overview

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 127.0.0.1 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.

OSX

Using the GUI

You can point your DNS settings to your local machine by navigating to System Preferences > Network > Advanced > DNS, and adding 127.0.0.1 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 127.0.0.1

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., 127.0.0.1 and 1.1.1.1).

  6. Select OK when done.

Linux

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

PreviousSetting up the light clientNextNamebase Record Assistant

Last updated 2 years ago

Was this helpful?