Anon Connection Wizard



The Anon Connection Wizard application helps users in censored Internet environments connect to the Tor network via a Tor Bridge and/or a proxy.

Users are prompted with questions about their network environment, like whether they live in a censored area. This information is then used by the program to generate the most suitable Tor configuration possible. In Whonix, this file is placed in the /usr/local/etc/torrc.d/ directory, while it resides in the /etc/torrc.d/ directory for other Linux distributions.


The following screenshots provide a visual impression of Anon Connection Wizard.

Figure: Main torrc Configuration Page

Main page.png

Figure: Default Bridge Page

Bridge page default.png

Figure: Custom Bridge Page

Bridge page custom.png

Figure: Local Proxy Configuration Page


Figure: Summary Configuration Page

Torrc page.png

Figure: Tor Network Bootstrapping Page


Anon Connection Wizard vs Tor Launcher[edit]

Anon Connection Wizard shares several similar functions with the current Tor-launcher, but the latter is considered to be "upstream" [1] of the former. As a consequence, Anon Connection Wizard developers are trying to maintain code compatibility with the latest version of Tor-launcher and collaborate closely in Tor Launcher's design and development process.

Despite this, both applications actually have very different use cases. The current implementation of Tor-launcher relies heavily on Tor Browser (which is based on Firefox), but not all Tor users are Tor Browser Bundle users. Many people still prefer to run core Tor with different torified applications ("system Tor users"), including all Whonix users. This group may prefer Anon Connection Wizard because it does not rely on Tor browser, and almost all dependencies have already been packaged in Debian.

Anon Connection Wizard vs Whonix Setup Wizard[edit]

For safety reasons, Whonix will not automatically connect to the public Tor network when it starts for the first time. Users are currently guided by the Whonix Setup Wizard, which is automatically started on the first run. Whonix Setup Wizard's primary limitation is failing to help the user configure a Tor Bridge or a proxy before connecting to Tor.

In the future, Anon Connection Wizard will either replace or be integrated into Whonix Setup Wizard.

Run Anon Connection Wizard[edit]

To run it.

If you are using Qubes-Whonix, complete the following steps.

Qubes App Launcher (blue/grey "Q") -> Whonix-Gateway ProxyVM (commonly named sys-whonix) -> Anon Connection Wizard

If you are using a graphical Whonix-Gateway, complete the following steps.

Start Menu -> Applications -> System -> Anon Connection Wizard

If you are using a terminal Whonix-Gateway, type.

kdesudo anon-connection-wizard

Configure Tor Bridges[edit]

Anon Connection Wizard currently offers three different types of bridges by default: obfs3, obfs4, and meek-azure. [2] [3] [4]

Option 1: Anon Connection Wizard has some built-in bridges. To use them, complete the following steps.

Select "Configure" in the beginning page -> Select "I need Tor bridges to bypass the Tor censorship" -> Select "Connect with provided bridges" -> Select a transport type that is suitable.

Option 2: If none of the default bridges work, the user can try to obtain a set of bridges manually. See Finding a Bridge and Choosing the Right Protocol. After obtaining a set of Tor bridges, complete the following step.

Select "Configure" in the beginning page -> Select "I need Tor bridges to bypass the Tor censorship" -> Select "Enter custom bridges" -> Copy and paste the set of bridges to that input box(one bridge per line)

Configure Proxy[edit]

Select "Use proxy before connecting to the Tor network" on the Proxy Configuration page -> Choose the proxy type -> Fill out other necessary information



Anon Connection Wizard was originally developed by troubadour as part of the Whonix Project. Some screenshots of the old version can be found in this Whonix blog post . Anon Connection Wizard was further developed by iry under a Google Summer of Code project. The development process is ongoing and there are future plans to integrate Anon Connection Wizard into the Tor Controller GUI.

Forum Discussion[edit]

Most of the development discussions can be found in this forum post.


  1. Upstream refers to the originator of the component being discussed.
  2. As at May 2018, domain fronting has been pulled by both Google and Amazon, meaning the meek-google and meek-amazon pluggable transports will no longer work.

Random News:

Did you know that Whonix could provide protection against backdoors? See Verifiable Builds. Help is wanted and welcomed.

https | (forcing) onion

Share: Twitter | Facebook

This is a wiki. Want to improve this page? Help is welcome and volunteer contributions are happily considered! See Conditions for Contributions to Whonix, then Edit! IP addresses are scrubbed, but editing over Tor is recommended. Edits are held for moderation.

Whonix is a licensee of the Open Invention Network. Unless otherwise noted, the content of this page is copyrighted and licensed under the same Libre Software license as Whonix itself. (Why?)