¶ Supported Windows Operating Systems
Windows 7 SP1 and their servers versions and up
Both x86 and x64 versions are supported but x64 is recommended due to ram consumption
¶ Software
Processor with SSE2 support
Boost ≥ 1.73 (latest stable recommended)
MySQL ≥ 5.7
OpenSSL = 1.1.x
CMake ≥ 3.18.4 (latest stable recommended)
MS Visual Studio (Community) ≥ 17.4 (2022) (Desktop) (Not previews)
¶ 1. Git
View this thread for important details on how to install Git for best results.
During Git installation - Adjusting your PATH environment. Pick "Run Git from the Windows Command Prompt"
¶ 1.1 Git Extensions
Git Extensions adds some visual extras and an improved UI for Git.
¶ 2. Visual Studio 2022
The installer for VS 2019 and higher (any edition) no longer installs the C++ compiler by default.
To enable it, select Custom in the type of installation and pick Desktop development with C++ as workload
If you are running a Windows 10 Creator/Anniversary Edition, you additional have to install one Windows 10 SDK via Indiviual components out of the ones available
You can also install it from command line with the command:
vs_community.exe /q /norestart /InstallSelectableItems NativeLanguageSupport_Group
or if you have enterprise version with:
vs_enterprise.exe /q /norestart /InstallSelectableItems NativeLanguageSupport_Group
¶ 3. MySQL Server Community Edition
- MySQL Server Community Edition Version 5.7
(not recommended, better use 8.0) - MySQL Server Community Edition Version 8.0
(highly recommended)
- Download the Windows MSI Installer.
- Scroll down to the bottom and click on "No thanks, just take me to the downloads!"
- When the installation is almost done, make sure "Launch the MySQL Instance Configuration Wizard" is checked, then click "Finish".
- When the MySQL Instance Configuration Wizard launches, most default options are fine, but remember the username and password you use (root // whatever). You will need them to log into your chosen database management tool (below) in order to import SQL files later.
- To test if MySQL is set up correctly, hit CTRL+ALT+DEL on your keyboard, enter the Task Manager, and select the "Services" tab. In the list of services you should see "MySQL" with a status of "Running".
- https://bugs.mysql.com/bug.php?id=76476
Please read the Suggested Bug Fix, as this works....or you will be in a loop of "wait for the DB to start?!?"
¶ 4. Database management tools
Choose one of these
- mysql cli (comes with MySQL installation)
(fastest and recommended) - SQLYog Community Edition
- HeidiSQL (Best for beginners)
- MySQL Workbench (already installed if you chose to install full MySQL package)
- DBeaver (Multiplattform Database Management Tool)
¶ 5. Test your tool
Try connecting to your MySQL instance that you installed above. Depending on the program, you may be looking for "Connect to Host" or "New Connection" or "Session Manager".
Create a new connection/session. The Hostname/IP address of "127.0.0.1" or "localhost" is fine if you installed MySQL on the same computer that you installed HeidiSQL or SQLYog. Simply fill in your root // whatever password and you should now be able to connect to your database
¶ 6. .NET Framework 3.5 or above
(you should already have it via your Windows updates)
¶ 7. Boost
Depending on your boost version, you require newer CMake version.
For example: boost 1.80 requires CMake 3.24.2 (with 3.24.1 it will throw warnings).
- Download the prebuilt Windows Binary for Visual Studio 2019 (or higher)
Here the links for minimum version:
If you prefer a higher Boost version check here: https://sourceforge.net/projects/boost/files/boost-binaries/
Not all version are currently supported by TrinityCore (minimum is 1.73) or CMake (e.g. CMake 3.24.1 will throw CMake errors with boost 1.80)
To find the correct version we will explain on example: boost_1_80_0-msvc-14.3-64.exe:
1_80_0 = Version 1.80
-msvc-14.3 = Toolset v143 for Visual Studio 2022 (https://docs.microsoft.com/en-us/cpp/porting/binary-compat-2015-2017?view=msvc-170)
-64 = 64bit
- Install the package to the default location (usually C:\local\boost_1_XX_0\ .)
- Add an environment variable to "System" variable named "BOOST_ROOT" and as value your Boost installation directory, e.g "C:/local/boost_1_72_0". Important is to use "/", not "\" when pointing to directory.
(Make sure that it does not have a trailing slash (end of path). If you still get problems, add the same variable in the "USER" variables section too, like shown in the image below.)
Notice that this image shows the version number 1.72.0 - use your actual version number in your settings.
¶ 8. CMake
- Download and install the Latest Release win32-x86.exe file, NEVER the RC (Release Candidate) versions.
- “Visual Studio 14” is Microsoft Visual Studio 2015, or Visual C++ 14.0, or MSC 19.0 (confusing, right?) If I need to build for 64-bit, then I choose “Visual Studio 14 Win64” we recommend to compile all on 64 bits mode
- Note: If used different MySQL server e.g Wampserver with included MySQL or any other software, then is needed to point cmake to that directory (the same way how it was done for BOOST). Add an environment variable to "System" variable named "MYSQL_ROOT" and as value your MySQL installation directory, e.g "c:/wamp/bin/mysql/mysql5.7.19". Important is to use "/", not "\" when pointing to directory.
¶ 9. MySQL development files
These files are shipped with MySQL Server, search for them at program files directory, MySQL\MySQL Server 8(5).X\lib and MySQL\MySQL Server 8(5).X\include.
¶ 10. OpenSSL
Do not download OpenSSL version 3.x.x
Download the 64bit version. Or you can get both if you plan to compile both 32 and 64bit, they can coexist side by side.
- Find the 64bit version by finding the latest 1.0.x or 1.1.x Win64 OpenSSL that is NOT the "light" or 3.x version.
- Example: Win64 OpenSSL v1.1.1L
- Example: Win64 OpenSSL v1.1.1L
- Find the 32bit version by finding the latest 1.0.x or 1.1.x Win32 OpenSSL that is NOT the "light" or 3.x version.
- Example: Win32 OpenSSL v1.1.1L
- Example: Win32 OpenSSL v1.1.1L
While installing OpenSSL, choose The OpenSSL binaries (/bin) directory (NOT "The Windows system directory")
when given the choice on where to copy the OpenSSL DLLs. These DLLs will need to be located easily for Core Installation.
¶ (Optional)
- If you use different PCs to compile/run Trinity, install one of the following packages on your Server-PC to avoid missing dependencies (depending on your Visual Studio Version and your Server-PC Operating System)
- Microsoft Visual C++ 2017 Redistributable Package
- NOTE: Whatever you do you CAN'T run TrinityCore on Windows XP or Windows 2003 or vista.
- TortoiseGit
- This instruction supports Git Extensions only, but TortoiseGit is another viable option if you're comfortable with the process.