Versions Compared

Key

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

Table of Contents

Overview

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

Note

Stubby has been tested on Windows 10 and should work on Windows 8. There is limited support for Windows 7 - see below.

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

...

Warning

The installer currently overwrites all existing files so if you have made changes to the stubby.yml then  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.4 6 built from:

  • getdns version: 1.46.1 (with custom fix for 

  • openssl version: 1.0.2s

  • stubby version: 0.3.0 

DescriptionFileSHA256 Checksum
64bit Windows Installer
abc0c103d56d620ef942b48d7c3c2713638587a397baecb003644c82816a0249
32bit Windows Installerstubby-0.3.0.6-x86.msi
a1afae37090c622304d4ea8ad593f277fed50b5bd2281032b4bb9522c1097e2e
Zip file with 64bit install
9e6b1480bc9690d8280a921499273d85c59bc7097ff7203efc2a7ba7351df2f7
Zip file with 32bit install
db742031551af20d611b011dea7827a6611281d28e8b3dcada7a8cc92fa4a0bb

Latest chocolatey package is available herehttps://

...

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.10.0g2s

  • stubby version: 0.2.0 (with updated config file to include Cloudflare)4.0rc1

NOTE: This is an alpha release!

DescriptionFileSHA256 Chechsum
Windows Installereae5bd3cd98aad54a3f9e7a3a41488e9d086cc3e39ce0756c05cac9419de1ea3
Zip file5f9c1aba49dc714b411b53bb5e9facb5f3729887cafb2eaeffba2f48bd69cffc

...

Checksum
64bit Windows Installer

2f5cc0b783cbaf7ada2d266cac89025c52789d8406da681e017af243372e21c4

32bit Windows Installer

7cb0d59baf1fd3049fc81eab98e4d8a83d385be09c74f0f9ea53884fb3655f91

Zip file with 64bit install

8a7992baaa1eba171934c1c3e5539cf91d88170f0cb734a58e0f132265b2454b

Zip file with 32bit install

35d75ecd1849590306433839fc2cd404ecadd986489f63497701e6c177c7055a

Release notes

Version 0.4.0-a2

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.

Info

The 0.3.0.6 release and later 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.

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

...

> "C:\Program Files\Stubby\stubby.exe" -"C:\Program Files\Stubby\stubby.yml" -l

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

...