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

We consider Windows support for the Stubby CLI to be Beta at this time. It
Warning
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!


Installation

Download and run the installer:    Stubby.msi

Info
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 

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-a1 built from:

  • getdns version: 1.6.0 

  • openssl version: 1.0.2s

  • stubby version: 0.4.0rc1 

NOTE: This is an alpha release!

DescriptionFileSHA256 Checksum
64bit Windows Installer

3be30ed58c91c4091302b3fc18cb25881f18b59ddb3848510511dd8e1ca60b85

32bit Windows Installer

fc1966953dbda6179033867d91e57daaaa212c53244adbd55e503e76ce9f101f

Zip file with 64bit install3672599e57ffb09416a25c55c455c5f850053fc6a2af21e22601e264ef4dbad3
Zip file with 32bit install

47655c722a2d97c83a88e0710acc93c3cc32968965fcca1faf65157ab217c4a7

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.

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:
  • 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"

...

> "C:\Program Files\Stubby\stubby.exe" -C "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).

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:

...

In most cases your system will use the 'default' DNS servers that are provided by whatever network you are on at the time. Using the two Powershell comands will be all you need to switch back and forth from Stubby to the default DNS settings for the network you are on. (The scripts don't store any DNS config information because it can change dynamically). If you want to double check what servers you are using right now you can use then follow the instructions below to inspect your system settings. If you have reason to think your system uses specific servers on all networks it might be useful to note your existing default nameservers before making this change so you can use the same instructions to reset them!

...

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

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

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 need to manually inspect or change your system revolvers on Windows through the GUI then do the following:

  1. Open the Control Panel
  2. Choose 'Network and Internet'
  3. Choose 'View network status and tasks' under 'Network and Sharing Center' 
  4. Choose 'Change adapter settings' from the left hand menu
  5. Then choose your interface - most likely either 'Wi-fi' or 'Ethernet'
  6. In the dialog that appears, click on the 'Properties' button at the bottom
  7. In the list that appears double click on 'Internet Protocol Version 4 (TCP/IPv4)'
    1. You can toggle your DNS between using the default DNS servers provided by the network you are on and setting specific servers using the botton radio buttons on this page
    2. Be sure to press OK and then Close to apply the settings. 
  8. Repeat step 7 for  'Internet Protocol Version 6 (TCP/IPv6)' if you have IPv6 enabled

A helpful screenshot (in German):

Image Added

Opportunistic mode

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