Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Warning

We consider Windows support for the Stubby CLI to be Beta at this time. It has been tested on Windows 10 and Windows 8. For There is limited support for Windows 7 advice - see below.

User testing reports, bug reports and patches/pull requests are all welcomed via the Stubby github issue tracker!


Installation

Note

The installer currently overwrites all existing files so if you have made changes to the stubby.yml then you should create a backup of this file before upgrading!


Download and run the 0.0.2 installer: 
  Stubby.msi

Info
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"

...

Info

We are working on support for running Stubby as a service on Windows 10. Instructions for setting up a Scheduled task are below.


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:

...

PowerShell -ExecutionPolicy bypass -file  "C:\Program Files\Stubby\stubby_resetdns_windows.ps1


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

Code Block
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.