Getting Started

Introduction

One of the main goals of the CMaNGOS Docker project is optimization.
To achieve this, two different types of images have been developed: the one used for maintainance (larger) and the one used for execution.

With this principle in mind, we can now begin! 🚀

First time run

First of all, you have to decide up to which client version you want your server to support.
Both CMaNGOS and CMaNGOS Docker use three keywords to identify it; select the one you need and keep it in mind for the next steps:

• classic → World of Warcraft® v1.12.x
• tbc → World of Warcraft: The Burning Crusade® v2.4.3
• wotlk → World of Warcraft: Wrath of the Link King® v3.3.5a

Download the images

Once you've selected the supported client version, you can download the related Docker images.
To do so, you need to open a shell or command prompt and type the following lines replacing the <version> placeholder with the keyword of your choice:

docker pull ghcr.io/byloth/cmangos/<version>:latest
docker pull ghcr.io/byloth/cmangos/<version>/builder:latest

e.g.

For instance, let's say I wish to support up to the tbc version of the client.

What I have to type is:

docker pull ghcr.io/byloth/cmangos/tbc:latest
docker pull ghcr.io/byloth/cmangos/tbc/builder:latest

Configuration

Actually, due to legal reasons and copyright policies, CMaNGOS (and -of course- CMaNGOS Docker) cannot be distributed ready-to-run (or -at least- not at 100% of its functionality)...
In fact, it needs some extra copyrighted files from Blizzard Entertainment®.

These files -on the other hand- are present within the WoW client: the same client you need to play.
For this reason, if you've purchased and legally own a copy of the client, you can use a tool to extract these files directly from it.

... to be continued...