Skip to content

Commit 696ce46

Browse files
committed
[Docs] Update Windows build instructions for using WSL and Ubuntu 17.04
1 parent 4f890ba commit 696ce46

File tree

1 file changed

+12
-4
lines changed

1 file changed

+12
-4
lines changed

doc/build-windows.md

Lines changed: 12 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,10 +4,11 @@ WINDOWS BUILD NOTES
44
Below are some notes on how to build Bitcoin Core for Windows.
55

66
Most developers use cross-compilation from Ubuntu to build executables for
7-
Windows. This is also used to build the release binaries.
7+
Windows. Cross-compilation is also used to build the release binaries.
88

9-
Currently only building on Ubuntu Trusty 14.04 is supported.
10-
Other versions are unsupported or known to be broken (e.g. Ubuntu Xenial 16.04).
9+
Currently only building on Ubuntu Trusty 14.04 or Ubuntu Zesty 17.04 or later is supported.
10+
Building on Ubuntu Xenial 16.04 is known to be broken, see extensive discussion in issue [8732](https://github.com/bitcoin/bitcoin/issues/8732).
11+
While it may be possible to do so with work arounds, it's potentially dangerous and not recommended.
1112

1213
While there are potentially a number of ways to build on Windows (for example using msys / mingw-w64),
1314
using the Windows Subsystem For Linux is the most straightforward. If you are building with
@@ -64,6 +65,13 @@ build process.
6465

6566
See also: [dependencies.md](dependencies.md).
6667

68+
If you're building on Ubuntu 17.04 or later, run these two commands, selecting the 'posix' variant for both,
69+
to work around issues with mingw-w64. See issue [8732](https://github.com/bitcoin/bitcoin/issues/8732) for more information.
70+
```
71+
sudo update-alternatives --config x86_64-w64-mingw32-g++
72+
sudo update-alternatives --config x86_64-w64-mingw32-gcc
73+
```
74+
6775
## Building for 64-bit Windows
6876

6977
To build executables for Windows 64-bit, install the following dependencies:
@@ -84,7 +92,7 @@ Then build using:
8492

8593
To build executables for Windows 32-bit, install the following dependencies:
8694

87-
sudo apt-get install g++-mingw-w64-i686 mingw-w64-i686-dev
95+
sudo apt-get install g++-mingw-w64-i686 mingw-w64-i686-dev
8896

8997
Then build using:
9098

0 commit comments

Comments
 (0)