Overview

This package install the command line interface for Stubby. A future release will include a Stubby can be installed

• either via the install/zip packages available on this page or 

• by using chocolatey: https://chocolatey.org/packages/stubby/0.3.0.6

  
  

  Info
  The 0.4.0 release msi and zip files includes both the command line tool described below and also an alpha release of a Graphical Interface to manage Stubby.

Installation

Download and run the installer:    Stubby.msi

SHA256 Checksum: 9622299c86738859fdfe5fefbe08950612229a74b9b66069ee79658edf18e115

...

Warning
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!

Latest stable msi and zip installers:

Latest stable installer is version 0.3.0.6 built from:

• getdns version: 1.6.0 

• openssl version: 1.0.2s

• stubby version: 0.3.0 

abc0c103d56d620ef942b48d7c3c2713638587a397baecb003644c82816a0249

a1afae37090c622304d4ea8ad593f277fed50b5bd2281032b4bb9522c1097e2e

9e6b1480bc9690d8280a921499273d85c59bc7097ff7203efc2a7ba7351df2f7

db742031551af20d611b011dea7827a6611281d28e8b3dcada7a8cc92fa4a0bb

Latest chocolatey package is available here: https://chocolatey.org/packages/stubby/0.3.0.6

Latest development msi and zip installers:

Latest development installer is version 0.4.0-a2 built from:

• getdns version: 1.6.0 

• openssl version: 1.0.2s

• stubby version: 0.4.0rc1

NOTE: This is an alpha release!

Release notes

Version 0.4.0-a2

• Significant updates to the Stubby Manager GUI - see here for details.

Version 0.4.0-a1

• The msi and zip files now includes an alpha release of Stubby Manager GUI see this page for details. This installs alongside the existing install and should not interfere with existing installs. (Chocolatey package does not contain this yet.) The alpha is not feature complete and should be used with care, see Stubby Manager GUI.
• Stubby can now be installed as a Windows service, see this README.md for details.

Version 0.3.0

• Update to use Stubby 0.3.0.
• This release is built with the Visual Studio toolchain. Previous releases were built with MinGW.

Version 0.2.6

• Update to use Stubby 0.2.6

Version 0.2.5

• Previous versions of the installer were numbered 0.0.1 to 0.0.7. From this release onward we are adopting a new policy. Installer releases will have a 4 component version a.b.c.d. a.b.c gives the Stubby version. d indicates the installer package revision, starting at 0 for the first packaging of a given Stubby version.

• The 0.2.5.0 release now provides a 32bit install as well as a 64bit install.

  • On a 64bit Windows installation, a 32bit install will place files in C:\Program Files (x86)\Stubby. All other installs place files in C:\Program Files\Stubby.

• This release corrects the default configuration file location to C:\Program Files\Stubby\stubby.yml. This path no longer needs to be specified on the command line.
• stubby.bat has been updated to look for the configuration file in the same directory as the Stubby executable.

Installer contents

These contain the following files by the installer.

• README.txt - containing these instructions
• stubby.exe    - binary
• stubby.yml    - configuration file
• getdns_query.exe - tool for testing stubby
• getdns_server_mon.exe - tool for probing servers
• Powershell scripts for modifying system resolvers:
• getdns commit: 12272dda368e81b519c7b192d8ee98dcd39d9720 (1.2.0 release with fixes from the develop branch)
• stubby version: 0.1.4
  • stubby_setdns_windows.ps1
  • stubby_resetdns_windows.ps1
    

This version of the installer is built from:

• • 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.xml

  • stubby.bat
• Additional files required for the Stubby Manager GUI

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"

...

The -l flag enables full logging. Alternatively a specific logging level can be controlled by using the -v flag (run '"C:\Program Files\Stubby\stubby.exe" - h'  for details of available levels).

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

Install Stubby as Windows service

See this README.md for details.

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.