Troubleshooting TOR

Troubleshooting TOR / TOR won't start

To send and receive via TOR, TOR needs to be running. Here is a List of known Issue(s) which might cause a Problem

Known Issues

• Tor can't start with Error 127 (Unix)
• Foreign API Listener bound to '0.0.0.0:3415' (Windows)
• Unable to start TOR Listener; Check that TOR is installed and on your path (CLI/Windows Only)

Tor can't start with Error 127 (Unix)

On some Unix Distributions the tor binary included with the QT may not be suitable. If you get an error "127" trying to start the wallet you need to use the allready included TOR binary of your Distro. You can change the tor_path in the mwc-gui-wallet-v3.conf file to the fullpath of TOR.

1. Open a Terminal and type "whereis tor" and copy this path
2. Move into ~/mwc-qt-wallet to edit the Configuration file and replace tor_path = "build in" with the path you received from step 1

Foreign API Listener bound to '0.0.0.0:3415' (Windows)

There is a known Issue on Windows where TOR is unable to start if the Foreign API Listener is bound to 0.0.0.0:3415

This may occur if Users changed their configuration as this Value will be set to 127.0.0.1:3415 by default from now on.

Solution: Set the Foreign API Listener to 127.0.0.1:3415 and restart the QT Wallet.

You can do this by:

1. Start and unlock your wallet

2. Enter the Listener Settings by clicking the Gear Icon and selecting "Listeners"

3. Click on "Configure" for the HTTP Listener, and set the Listener IP to 127.0.0.1:3415:

---

Unable to start TOR Listener; Check that TOR is installed and on your path (CLI/Windows Only)

There is a known Issue on Windows with the CLI Wallet where TOR may be unable to start if the path to tor.exe is not included in your %PATH% Variable.

Requirements:

An installed Version of Tor as the CLI currently does not include this like the QT-wallet does.

Solution:

Add the path to tor.exe in the %path% Environment Variable, or the fullpath in the %TOR_EXE_NAME% Environment Variable

You can do this by one of the following 2 methods:

1. Adding Tor.exe path to %path% Variable
   1.1) Open the searchbar of Windows (Click the start Button)
   1.2) Type in variables in the searchbar and open Edit the system environment variables
   1.3) Click the “Environment Variables…“ button.
   1.4) Under the “System Variables” section (the lower half), find the row with Path in the first column, and click edit.
   1.5) Now click the Button “New” and type in the path of the tor executable.
   (C:\Users\%username%\Desktop\Tor Browser\Browser\TorBrowser\Tor by default)
   1.6) Then save by clicking “ok“
   1.7) Restart your System
   

If this doesn't work even after a Reboot, try the second Method to set the Tor executable explicitly.

2. Adding Tor.exe fullpath to %TOR_EXE_NAME% Variable
   2.1) Open the searchbar of Windows (Click the start Button)
   2.2) Type in variables in the searchbar and open Edit the system environment variables
   2.3) Click the “Environment Variables…“ button.
   2.4) Under the “System Variables” section (the lower half), click the "New..." Button
   2.5) Enter TOR_EXE_NAME as Name, and set the "Value" to the fullpath of tor.exe
   (C:\Users\%username%\Desktop\Tor Browser\Browser\TorBrowser\Tor\tor.exe by default)
   2.6) Then save by clicking “ok“
   2.7) Restart your System