diff --git a/appveyor.yml b/appveyor.yml
index 44c222aff..8430a125f 100644
--- a/appveyor.yml
+++ b/appveyor.yml
@@ -60,7 +60,8 @@ install:
   - SET p=x86
   - IF "%platform%"=="x64" SET p=x64
   - curl -fsSL https://github.com/Z3Prover/z3/releases/download/z3-4.8.7/z3-4.8.7-%p%-win.zip -o z3-4.8.7-win.zip
-  - 7z e z3-4.8.7-win.zip -oz3 -r -y
+  - 7z x z3-4.8.7-win.zip -oexternals -r -y
+  - move externals\z3-4.8.7-%p%-win externals\z3
 
 build_script:
   - ECHO Building %configuration% %platform% with MSVC %VisualStudioVersion% using %PlatformToolset% PlatformToolset
diff --git a/gui/gui.pro b/gui/gui.pro
index 9f809ae92..14691544c 100644
--- a/gui/gui.pro
+++ b/gui/gui.pro
@@ -7,7 +7,7 @@ DEPENDPATH += . \
     ../lib
 INCLUDEPATH += . \
     ../lib \
-    ../z3
+    ../externals/z3/include
 QT += widgets
 QT += printsupport
 
@@ -15,7 +15,7 @@ contains(LINKCORE, [yY][eE][sS]) {
     LIBS += -l../bin/cppcheck-core
     DEFINES += CPPCHECKLIB_IMPORT
 }
-LIBS += -L$$PWD/../externals -L$$PWD/../z3
+LIBS += -L$$PWD/../externals -L$$PWD/../externals/z3/bin
 
 # z3
 win32 {
diff --git a/readme.txt b/readme.txt
index eecdac06b..247be1662 100644
--- a/readme.txt
+++ b/readme.txt
@@ -22,6 +22,14 @@ Compiling
 
     When building the command line tool, PCRE is optional. It is used if you build with rules.
 
+    For "bug hunting" you need Z3. Installing Z3:
+     * debian: "sudo apt-get install libz3-dev
+     * windows:
+       32-bit: https://github.com/Z3Prover/z3/releases/download/z3-4.8.7/z3-4.8.7-x86-win.zip
+       64-bit: https://github.com/Z3Prover/z3/releases/download/z3-4.8.7/z3-4.8.7-x64-win.zip
+    If you do not want to install z3 in some "system" include/lib paths you can put the files in
+    cppcheck/externals/z3/include and cppcheck/externals/z3/bin
+
     There are multiple compilation choices:
       * qmake - cross platform build tool
       * cmake - cross platform build tool