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

...

SHA256 Checksum: 5a3ea837174be848fd296eaa1d5910aa24001c634cf32e478d007cca05e49d9d

...

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-a1 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-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:
  • 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.batxml

  • stubby.xml

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

• getdns version: 1.2.1rc-1 (with minor fixes)

• stubby version: 0.2.0

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

...

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

...

• 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
  

  We have had reports of an issue on Windows 7 where one of the latest optional updates is required for certificate verification to work: see this issue.

  
  
  

Anchor
win_instructions win_instructions

Manual update of system revolvers on Windows

...