Opened 9 years ago

Last modified 16 months ago

#4260 assigned enhancement

[PATCH] Update TOR build instructions for mingw

Reported by: Tey' Owned by: erinn
Priority: High Milestone: Tor: unspecified
Component: Core Tor/Tor Version: Tor:
Severity: Normal Keywords: tor-client build documentation windows
Cc: erinn, teyut@… Actual Points:
Parent ID: Points:
Reviewer: Sponsor:



I've updated the documentation for building TOR on MinGW, and attached the result (and the patch). Please, consider replacing the file <doc/tor-win32-mingw-creation.txt> with it.

Here are the main changes:

  • the MinGW installer includes the MSYS and DTK packages, so there no need to download and install them separately.
  • there's no more issue with symlinks for openssl.
  • specifying "mingw" to the "Configure" command is enough to disable openssl ciphers/hashes that don't compile on MinGW.
  • since v1.2.5, zlib needs some extra (?) environment variables for its installation.
  • the libraries download links have been updated so that they point to the latest version to date.
  • instructions for executing unit-tests have been added for the libraries and TOR.

Maybe zlib should be built before openssl since some optional features of openssl seems to depend on zlib. I followed these instructions in order to build TOR successfully on my WinXP computer.

Child Tickets

Attachments (2)

tor-win32-mingw-creation.txt (3.0 KB) - added by Tey' 9 years ago.
tor-win32-mingw-creation.txt.patch (4.7 KB) - added by Tey' 9 years ago.

Download all attachments as: .zip

Change History (12)

Changed 9 years ago by Tey'

Changed 9 years ago by Tey'

comment:1 Changed 9 years ago by rransom

Status: newneeds_review

I'm not a big fan of using or recommending a program which will download and automatically unpack unsigned binaries. (But this patch isn't my call.)

comment:2 Changed 9 years ago by nickm

Cc: erinn added

Hm. Are we using those instructions with current packages for Tor? If not, we should actually remove them entirely and replace them with a link to the instructions that we *are* using.

Erinn maintains the TBB build instructions, I think. Let's ask Erinn!

comment:3 Changed 9 years ago by Tey'

Cc: teyut@… added

I can probably document the manual way to install the MinGW/MSYS environment, but you'll still have to download unsigned binaries for that since the MinGW team doesn't sign their releases (as far as I know).

If the official Tor releases for Windows are built differently, I agree it'll be better to know the official build instructions. But I doubt this is the case since there are references to MinGW libs in the official Tor binary for Windows (though the executable size is way smaller than the size of the executable built using the instructions I followed). Anyway, let's way for Erinn's comment.

comment:4 Changed 9 years ago by erinn

Owner: set to erinn
Status: needs_reviewassigned

Hi Tey! Thanks a lot for the patch. I have a deadline for something related (buildbot stuff for Windows) and will be able to fully review and implement documentation changes after Nov 30.

comment:5 Changed 9 years ago by Lundberg

This patch is what I lacked when building for Windows. I got pointed to this link ( and that helped me through. The changes proposed by Tey' seems to be backed up by the guide written by Sebastian.

comment:6 Changed 9 years ago by nickm

Milestone: Tor: unspecified

comment:7 Changed 8 years ago by nickm

Keywords: tor-client added

comment:8 Changed 8 years ago by nickm

Component: Tor ClientTor

comment:9 Changed 3 years ago by nickm

Keywords: build documentation windows added
Priority: MediumHigh
Severity: Normal

comment:10 Changed 16 months ago by cypherpunks

the official or comes without libs, why no lzma or Libzstd?
please add this flags!

./configure --enable-lzma
Tor running on Windows 10 [or later] with Libevent 2.1.8-stable, OpenSSL 1.1.1, Zlib 1.2.11, Liblzma 5.2.4, and Libzstd 1.3.8

Note: See TracTickets for help on using tickets.