...

Installation

Download and run the 0.0.2 installer:    Stubby.msi

SHA256 Checksum: 9622299c86738859fdfe5fefbe08950612229a74b9b66069ee79658edf18e1155a3ea837174be848fd296eaa1d5910aa24001c634cf32e478d007cca05e49d9d

This installs the following files in C:\Program Files\Stubby\

• README.txt - containing these instructions
• stubby.exe    - binary
• stubby.yml    - configuration file
• getdns_query.exe - tool for testing stubby
• Powershell scripts for modifying system resolvers:
  • stubby_setdns_windows.ps1
  • stubby_resetdns_windows.ps1
    

  • Windows 7 versions of Powershell scripts (see below)

    • stubby_setdns_windows7.ps1

    • stubby_resetdns_windows7.ps1

• Scripts to enable Stubby to be configured as a Scheduled Task

  • stubby.bat

  • stubby.xml

This version of the installer (0.0.2) is built from:

• getdns

  commit

  version:

   12272dda368e81b519c7b192d8ee98dcd39d9720 (

  1.2.

  0 release with fixes from the develop branch

  1rc-1 (with minor fixes)

• stubby version: 0.

  1

  2.

  4

  0

Configuration

It is recommended to use the default configuration file provided which will use 'Strict' privacy mode and spread the DNS queries among several of the current DNS Privacy test servers. Note that this file contains both IPv4 and IPv6 addresses. It installed in "C:\Program Files\Stubby\stubby.yml"

...

Test Stubby

A quick test can be done by opening a separate Command prompt window and using getdns_query (or your favourite DNS tool) on the loopback address:

...

Modify your upstream resolvers (Windows 7)

Follow the procedure above, but use the scripts:

• C:\Program Files\Stubby\stubby_setdns_windows7.ps1 and

• C:\Program Files\Stubby\stubby_resetdns_windows7.ps1
  
  

  Warning
  WARNING: These scripts can only update DNS servers on the IPv4 service. IPv6 will still use the default DNS servers, sending queries in clear text so one option is to disable IPv6, the other is to manually update the IPv6 addessses (see below).

Create a Scheduled Task

If you want Stubby to always start when you boot your system, you can create a Scheduled task for this. A template for the task is provided.

To create the task just run

schtasks /create /tn Stubby /XML "C:\Program Files\Stubby\stubby.xml" /RU <you_user_name>

Known Issues

• We are aware of occasional issues when Windows sleeps and resumes when stubby must be restarted to work correctly. 
  
  
• If you get an error when trying to run Stubby that includes the words "Could not bind on given address" then retry the command from an 'Administrator' Command prompt window
  
  
• The '-h' output of stubby.exe shows the wrong path for the installed configuration file. An issue has been opened for this.
  

• The installer currently overwrites the stubby.yml file so if changes have been made a backup should be created before upgrading

Anchor
win_instructions win_instructions

Manual update of system revolvers on Windows

...

If you have changed the default config in the stubby.yml file and are running in Opportunistic mode then you may want to add an alternative DNS server in here for robustness. However DNS queries sent to this server will be sent clear text over UDP/TCP, so this is NOT recommended for Strict mode unless required for bootstrapping (e.g. in a corporate network).

...

This release has not been tested on Windows 7 but we have user reports that Stubby works fine on Windows 7. However, the Powershell scripts release with the installer do not work on Windows 7. Windows 7 users can manually update their system resolvers using the instructions above, or see this issue for a suggested script that should work on Windows 7. We hope to include Windows 7 scripts in the next version of the installer.