TrinityCore : TrinityCore Requirements


Platform: Linux, Windows ≥ 7 SP1 or Mac

The following are the various software needed to compile the core successfully. Most are cross-platform.

Processor with SSE2 support
Boost ≥ 1.49 (≥ 1.54 iff build with Clang)
MySQL ≥ 5.1.0
OpenSSL ≥ 1.0.0
CMake ≥ 2.8.12 (Windows) | ≥ 2.8.9 (Linux)
ZeroMQ ≥ 3.2.4 (Windows) | ≥ 2.2.6 (Linux) (4.3.4 and 6.x branches only)
GCC ≥ 4.7.2 or Clang ≥ 3.3 (Linux)
MS Visual Studio (Express) ≥ 12 (2013) Desktop (Windows)


Below you will find general install guidelines for each supported platform. Please note that for command-based OSes, the syntax may vary depending on the versions.

Debian based linux

sudo apt-get install build-essential autoconf libtool gcc g++ make cmake git-core
sudo apt-get install wget p7zip-full libncurses5-dev
sudo apt-get install openssl libssl-dev mysql-server mysql-client libmysqlclient15-dev
sudo apt-get install libmysql++-dev libreadline6-dev zlib1g-dev libbz2-dev
sudo apt-get install libboost-dev libboost-thread-dev libboost-system-dev libboost-filesystem-dev libboost-program-options-dev

# for 4.3.4 and 6.x branches ONLY
sudo apt-get install libzmq-dev 

Continue with Linux installation guide


RedHat-based linux

yum groupinstall "Development Tools"
yum groupinstall "Additional Development"
yum install gcc-g++ git-core wget links zip unzip unrar cmake
yum install mysql-server mysql-client mysql-devel
yum install openssl


If you are compiling for 4.3.4 or 6.x you will also need to make and install zeromq from source:

tar xzvf zeromq-4.0.5.tar.gz
cd zeromq-4.0.5
make install




Continue with Linux installation guide


  1. GitExtensions
    1. Includes Git, MySYSGit, and KDiff - be sure to install all three
    2. View this thread for important details on how to install Git for best results. Default install options for KDiff and MySYSGit are acceptable.
      1. During Git installation - Adjusting your PATH environment. Pick "Run Git from the Windows Command Prompt".

  2. Install the compiler Visual C++ 2013 Express

  3. MySQL Server Community Edition (Use the most recent 5.5.x version)
    1. Download the Windows MSI Installer. 
    2. Scroll down to the bottom and click on "No thanks, just take me to the downloads!"
    3. When the install is almost done, make sure "Launch the MySQL Instance Configuration Wizard" is checked, then click "Finish".
    4. 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.
    5. 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".

  4. Choose one of these database management tools:

    1. mysql cli (Fastest (recomended since we use some very big files))

    2. SQLYog Community Edition

    3. HeidiSQL (Best for beginners)

    4. MySQL Workbench (already installed if you chose to install full MySQL package)

  5. Try connecting 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".

  6. Create a new connection/session. The Hostname/IP address of "" 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.NET Framework 3.5 or above (you should already have it via your Windows updates)

  7. Boost
    1. Download the prebuilt Windows Binary matching your platform
      1. Recommended for 64bit:
      2. Recommended for 32bit:
    2. Install the package to the default location.
    3. Add an environment variable to "system" variables named "BOOST_ROOT" pointing to your Boost installation directory, e.g "C:\local\boost_1_55_0".
    4. Restart Cmake if it was already running
    5. Note: If CMake errors about Boost, install both Boost 32 and 64 bits version to the same directory (e.g "C:\local\boost_1_55_0").

  8. CMake
    1. Download and install the win32-x86.exe file
    2. CMake 3.0.0: if it does not recognize the Visual C++ compiler location, use CMake 2.8.x. 
    3. “Visual Studio 12” is Microsoft Visual Studio 2013, or Visual C++ 12.0, or MSC 18.0 (confusing, right?) If I need to build for 64-bit, then I choose “Visual Studio 12 Win64”;

  9. MySQL development files
    1. These files are shipped with MySQL Server but to make it easier we packed the libs and include files for both 32 bits and 64 bits.
    2. Extract the files to a known location, e.g, C:/mysql_libs

  10. OpenSSL- Download the 32bit version. Or you can get both if you plan to compile both 32 and 64bit, they can coexist side by side.
    1. Find the 32bit version by finding the latest Win32 OpenSSL that is NOT the "light" version.
      1. Example: Win32 OpenSSL v1.0.1i
    2. Find the 64bit version by finding the latest Win64 OpenSSL that is NOT the "light" version.
      1. Example: Win64 OpenSSL v1.0.1i
    3. Note #1: If you get a "Missing Microsoft Visual C++ 2008 Redistributables" error message while installing OpenSSL, download the Microsoft Visual C++ 2008 Redistributable Package (x86) (1.7MB Installer) and install it.
      If you need 64bit support, download and install the Microsoft Visual C++ 2008 Redistributable Package (x64). Both these are linked from as well.
    4. Note #2: 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 Compiling the Source.

  11. ZeroMQ
    1. x64 -
    2. or x86 -


  1. 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)
    1. Microsoft Visual C++ 2013 Redistributable Package
    2. NOTE: Whatever you do you CAN'T run TrinityCore on Windows XP or Windows 2003.
  2. TortoiseGit
    1. This instruction supports Git Extensions only, but TortoiseGit is another viable option if you're comfortable with the process.




Xcode: Available in the App Store. After install run "xcodeselect --install" from terminal to install the required command line tools.
MySQL Community Server: -> "Mac OS X 10.9 (x86, 64-bit), DMG Archive"
GNU Readline:


Continue with Mac installation guide