Install prerequisites

  • CMake >= 3.15.1

  • Git >= 1.7.10

    • Note CMake must be able to find git.exe and patch.exe. If git is installed in the default location then they may be found there, but if they are not found then either add the folder that contains them to PATH environment variable; or set GIT_EXECUTABLE and Patch_EXECUTABLE as environment variables or as CMake variables at configure time.

  • NSIS (optional): Needed if packaging Slicer. Make sure you install the language packs.

  • Qt5: Download Qt universal installer and install Qt 5.15.1 components: MSVC2019 64-bit, Qt Script, Qt WebEngine. Installing Sources and Qt Debug Information Files are recommended for debugging (they allow stepping into Qt files with the debugger in debug-mode builds).

  • Visual Studio

    • any edition can be used (including the free Community edition)

    • when configuring the installer, enable Desktop development with C++ and in installation details, check MSVC v142 - VS2019 C++ x64... (Visual Studio 2019 v142 toolset with 64-bit support) - in some distributions, this option is not enabled by default

Other versions:

  • Visual Studio 2017 (v141) toolset is not tested anymore but probably still works. Qt-5.15.1 requires v142 redistributables, so either these extra DLL files need to be added to the installation package or each user may need to install “Microsoft Visual C++ Redistributable” package.

  • Visual Studio 2015 (v140) toolset is not tested anymore and probably does not work. Requires Qt 5.10.x to build due to QtWebEngine.

  • Cygwin: not tested and not recommended. Building with cygwin gcc not supported, but the cygwin shell environment can be used to run git, svn, etc.

Set up source and build folders

  • Create source folder. This folder will be referred to as <Slicer_SOURCE> in the following. Recommended path: C:\D\S4

    • Due to maximum path length limitations during build the build process, source and build folders must be located in a folder with very short (couple of characters) total path length.

    • While it is not enforced, we strongly recommend you to avoid the use of spaces for both the source directory and the build directory.

  • Create build folder. This folder will be referred to as <Slicer_BUILD> in the following. Recommended path: C:\D\S4R for release-mode build, C:\D\S4D for debug-mode build.

    • You cannot use the same build tree for both release or debug mode builds. If both build types are needed, then the same source directory can be used, but a separate build directory must be created and configured for each build type.

  • Download source code into Slicer source folder from GitHub:

    • The following command can be executed in Slicer source folder to achieve this: git clone .

  • Configure the repository for developers (optional): Needed if changes need to be contributed to Slicer repository.

    • Right-click on <Slicer_SOURCE>/Utilities folder in Windows Explorer and select Git bash here

    • Execute this command in the terminal (and answer all questions): ./

    • Note: more information about how to use git in Slicer can be found on this page

Configure and build Slicer

Using graphical user interface (alternative solution)

  • Run CMake (cmake-gui) from the Windows Start menu

  • Set Where is the source code to <Slicer_SOURCE> location

  • Set Where to build the binaries to <Slicer_BUILD> location. Do not configure yet!

  • Add Qt5_DIR variable pointing to Qt5 folder: click Add entry button, set Name to Qt5_DIR, set Type to PATH, and set Value to the Qt5 folder, such as C:\Qt\5.15.1\msvc2019_64\lib\cmake\Qt5.

  • Click Configure

  • Select your compiler: Visual Studio 16 2019, and click Finish

  • Click Generate and wait for project generation to finish (may take a few minues)

  • Click Open Project

  • If building in release mode:

    • Open the top-level Slicer.sln file in the build directory in Visual Studio

    • Set active configuration to Release. Visual Studio will select Debug build configuration by default when you first open the solution in the Visual Studio GUI. If you build Slicer in release mode and accidentally forget to switch the build configuration to Release then the build will fail. Note: you can avoid this manual configuration mode selection by setting CMAKE_CONFIGURATION_TYPES to Release in cmake-gui.

  • Build the ALL_BUILD project

Run Slicer

Run <Slicer_BUILD>/Slicer-build/Slicer.exe application.

Note: Slicer.exe is a “launcher”, which sets environment variables and launches the real executable: <Slicer_BUILD>/Slicer-build\bin\Release\SlicerApp-real.exe (use Debug instead of Release for debug-mode builds).

Test Slicer

  • Start Visual Studio with the launcher:

Slicer.exe --VisualStudioProject
  • Select build configuration. Usually Release or Debug.

  • In the “Solution Explorer”, right click on RUN_TESTS project (in the CMakePredefinedTargets folder) and then select Build.

Package Slicer (create installer package)

  • Start Visual Studio with the launcher:

Slicer.exe --VisualStudioProject
  • Select Release build configuration.

  • In the “Solution Explorer”, right click on PACKAGE project (in the CMakePredefinedTargets folder) and then select Build.

Debug Slicer

  • C++ debugging: Visual Studio is recommended on Windows, see instructions.

  • Python debugging: multiple development environments can be used, see instructions.

Common errors

See list of issues common to all operating systems on Common errors page.