aboutsummaryrefslogtreecommitdiff
path: root/doc/UnixInstall.txt
blob: 5334c9cbee60063b04dfd20c086f46f1f3670595 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
= TrinityCore -- Linux installation =
This file is part of the TrinityCore Project. See AUTHORS file for Copyright information

=========================================================
WARNING: THIS DOCUMENTATION IS NOT ALWAYS UP TO DATE.
FOR MORE UP-TO-DATE INFORMATION, CHECK THE TRINITY WIKI.
=========================================================

CHECK https://www.trinitycore.info/ FOR FURTHER HELP.

These are the instructions for installation in a Linux environment.
If you are using Windows, refer to https://www.trinitycore.info/ .

Installing TrinityCore is fairly simple on a Linux machine,
assuming you have all the required applications installed:

https://www.trinitycore.info/display/tc/Requirements

Most of these are included on common Linux distros, you may have to
install others by yourself. Please check your distro's repo for specifics.

Make a directory to build in, you can call it anything you want (like
build or bin etc.), then go into the directory and use cmake and make.
E.g. you created a dir named build and want to have your final compiled product
installed in /home/trinity/server/. An example sequence of commands can be:

    cmake ../ -DCMAKE_INSTALL_PREFIX=/home/trinity/server -DTOOLS=1 -DWITH_WARNINGS=1
    make
    make install

That's just about all that is needed. You can, however, tweak more settings
than where to install, using flags built into our cmake files. Just open up
CMakeLists.txt in the main folder and take a look at some of the flags like

    SERVERS                 Build worldserver and authserver
    SCRIPTS                 Build core with scripts included
    TOOLS                   Build maps/mmaps/vmaps extraction/assembler tools
    USE_SCRIPTPCH           Use precompiled headers when compiling scripts
    USE_COREPCH             Use precompiled headers when compiling servers
    WITH_WARNINGS           Show all warnings during compile
    WITH_COREDEBUG          Include additional debug-code in core
    CMAKE_INSTALL_PREFIX    Set installation directory
    NOJEM                   Do not build with jemalloc (advanced users only)
    CONF_DIR                Set path as default configuration directory
    LIBSDIR                 Set path as default library directory
    CMAKE_C_FLAGS           Set C_FLAGS for compile (advanced users only)
    CMAKE_CXX_FLAGS         Set CXX_FLAGS for compile (advanced users only)
    CMAKE_BUILD_TYPE        Set build type - the supported modes are:
                            Release, MinSizeRel, RelWithDebInfo, Debug

Of course, replace the paths in CMAKE_INSTALL_PREFIX with the directory you wish to
install TrinityCore to. The datadir is where maps, DBCs, and SQLs are stored.
The sysconfdir is where configuration files are stored.

Once TrinityCore is installed, you will need to apply database updates
where necessary. Furthermore, you must configure your installation by
editing the config files in the sysconfdir.