A dockerized Vanilla WoW environment
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
data Added note about minimal Docker Engine version Mar 28, 2018
.editorconfig Added initial Docker environment Mar 15, 2018
.gitignore Fixed use of `.env` file Apr 5, 2018
CHANGELOG.md Fixed use of `.env` file Apr 5, 2018
FAQ.md Added FAQ Mar 29, 2018
LICENSE.md Fixed license copyright notice Mar 29, 2018
MAINTAINERS Added initial Docker environment Mar 15, 2018
README.md Fixed console markup Apr 24, 2018


WowStack: a dockerized Vanilla WoW environment

Running Vanilla Wow can be quite the drag if compiling and maintaining a moving Open Source project is not your forté.

Now things are easier. This provides a containerized environment for running a full environment supporting Vanilla WoW, and allows enjoying a long-gone game of World of Warcraft using client 1.12.x (in your prefered locale).

We now have a FAQ up, answering some of the questions we received.


Since this is all prebuilt and updated by us, all you have to worry about is having Docker and Docker Compose installed.

Feel free to use Docker for Mac OS, Docker for Windows or Docker for Linux, all work the same.

Docker Engine 1.13 or newer is required.


Copy .env.dist to .env and cutomize the settings to your liking or leave them as is for default behaviour.

To reduce initial start times pull all Docker containers required by executing:

docker-compose pull

This will retrieve the WowStack containers for map data, the authentication server, and the game world server. To support this, we will also pull a MariaDB container to house the game content during runtime.

As with any composed Docker environment, running the Vanilla WoW environment is simple:

docker-compose up -d

When shutting down the containers, we recommend to also prune any created volumes, as this avoids issues with importing the base data into MariaDB:

docker-compose down
docker volume prune -f

Extracting Vanilla WoW client data manually

Take note to a few things here:

  • -v $HOME/Applications/World\ of\ Warcraft:/opt/wowstack/data is passed on to supply the container with the Vanilla World of Warcraft game installation. Pass in the base directory, e.g. C:/World\ of\ Warcraft or $HOME/WoW-enGB
  • -v `pwd`/data/wowstack:/opt/wowstack/share is passed in as output directory for generated files. This directory is then mounted to the world server.
$ docker run \
    --name wow_map_generation \
    -v $HOME/Applications/World\ of\ Warcraft:/opt/wowstack/data \
    -v `pwd`/data/wowstack:/opt/wowstack/share \
    -d wowstack/map-tools:latest

This process might take a few hours to complete. Setting WOWSTACK_FORCE_REBUILD to yes will trigger regeneration of all data even if there already are files from previous runs.

Docker images

All Docker images are available on the Docker Hub, and updated frequently.

Since this is a work in progress project, we highly recommend to frequently run docker-compose pull before running the containers (at least weekly).