AzerothCore

v17.0.0-dev

A modular open source World of Warcraft: Wrath of the Lich King 3.3.5a game server emulator.

gaming mmorpg server

Deploy on Dokploy

Website GitHub Documentation

Deploy AzerothCore on Dokploy

Install Dokploy on your server if you haven't already.
In your Dokploy panel, open a project and click Create Service → Template.
Search for AzerothCore and click Create — Dokploy configures domains, environment variables, and volumes for you.

Alternatively, create a Compose service, go to Advanced → Import from Base64, and paste this payload:

base64

ewogICJjb21wb3NlIjogIiMgZG9rcGxveTogYWxsb3ctaG9zdC1wb3J0cyDigJQgV29XIGNsaWVudHMgY29ubmVjdCBkaXJlY3RseSBvdmVyIHJhdyBUQ1AgKDM3MjQgYXV0aGVudGljYXRpb24sIDgwODUgd29ybGQpOyBUcmFlZmlrIGNhbm5vdCByb3V0ZSB0aGUgZ2FtZSBwcm90b2NvbC5cbnZlcnNpb246IFwiMy44XCJcblxuc2VydmljZXM6XG4gIGF6ZXJvdGhjb3JlLWRhdGFiYXNlOlxuICAgIGltYWdlOiBteXNxbDo4LjQuMTFcbiAgICByZXN0YXJ0OiB1bmxlc3Mtc3RvcHBlZFxuICAgIGVudmlyb25tZW50OlxuICAgICAgTVlTUUxfUk9PVF9QQVNTV09SRDogJHtNWVNRTF9ST09UX1BBU1NXT1JEfVxuICAgIHZvbHVtZXM6XG4gICAgICAtIGF6ZXJvdGhjb3JlLWRhdGFiYXNlOi92YXIvbGliL215c3FsXG4gICAgaGVhbHRoY2hlY2s6XG4gICAgICB0ZXN0OlxuICAgICAgICBbXG4gICAgICAgICAgXCJDTUQtU0hFTExcIixcbiAgICAgICAgICBcIm15c3FsYWRtaW4gcGluZyAtLWhvc3Q9MTI3LjAuMC4xIC0tcHJvdG9jb2w9VENQIC0tdXNlcj1yb290IC0tcGFzc3dvcmQ9JCR7TVlTUUxfUk9PVF9QQVNTV09SRH1cIixcbiAgICAgICAgXVxuICAgICAgaW50ZXJ2YWw6IDVzXG4gICAgICB0aW1lb3V0OiAxMHNcbiAgICAgIHJldHJpZXM6IDQwXG4gICAgICBzdGFydF9wZXJpb2Q6IDIwc1xuXG4gIGF6ZXJvdGhjb3JlLWRiLWltcG9ydDpcbiAgICBpbWFnZTogYWNvcmUvYWMtd290bGstZGItaW1wb3J0OjE3LjAuMC1kZXZcbiAgICByZXN0YXJ0OiBcIm5vXCJcbiAgICBlbnZpcm9ubWVudDpcbiAgICAgIEFDX0RBVEFfRElSOiAvYXplcm90aGNvcmUvZW52L2Rpc3QvZGF0YVxuICAgICAgQUNfTE9HU19ESVI6IC9hemVyb3RoY29yZS9lbnYvZGlzdC9sb2dzXG4gICAgICBBQ19MT0dJTl9EQVRBQkFTRV9JTkZPOiBhemVyb3RoY29yZS1kYXRhYmFzZTszMzA2O3Jvb3Q7JHtNWVNRTF9ST09UX1BBU1NXT1JEfTthY29yZV9hdXRoXG4gICAgICBBQ19XT1JMRF9EQVRBQkFTRV9JTkZPOiBhemVyb3RoY29yZS1kYXRhYmFzZTszMzA2O3Jvb3Q7JHtNWVNRTF9ST09UX1BBU1NXT1JEfTthY29yZV93b3JsZFxuICAgICAgQUNfQ0hBUkFDVEVSX0RBVEFCQVNFX0lORk86IGF6ZXJvdGhjb3JlLWRhdGFiYXNlOzMzMDY7cm9vdDske01ZU1FMX1JPT1RfUEFTU1dPUkR9O2Fjb3JlX2NoYXJhY3RlcnNcbiAgICB2b2x1bWVzOlxuICAgICAgLSBhemVyb3RoY29yZS1jb25maWc6L2F6ZXJvdGhjb3JlL2Vudi9kaXN0L2V0Y1xuICAgICAgLSBhemVyb3RoY29yZS1sb2dzOi9hemVyb3RoY29yZS9lbnYvZGlzdC9sb2dzXG4gICAgZGVwZW5kc19vbjpcbiAgICAgIGF6ZXJvdGhjb3JlLWRhdGFiYXNlOlxuICAgICAgICBjb25kaXRpb246IHNlcnZpY2VfaGVhbHRoeVxuXG4gIGF6ZXJvdGhjb3JlLWNsaWVudC1kYXRhOlxuICAgIGltYWdlOiBhY29yZS9hYy13b3Rsay1jbGllbnQtZGF0YToxNy4wLjAtZGV2XG4gICAgcmVzdGFydDogXCJub1wiXG4gICAgdm9sdW1lczpcbiAgICAgIC0gYXplcm90aGNvcmUtY2xpZW50LWRhdGE6L2F6ZXJvdGhjb3JlL2Vudi9kaXN0L2RhdGFcblxuICBhemVyb3RoY29yZS1yZWFsbS1jb25maWc6XG4gICAgaW1hZ2U6IG15c3FsOjguNC4xMVxuICAgIHJlc3RhcnQ6IFwibm9cIlxuICAgIGVudmlyb25tZW50OlxuICAgICAgTVlTUUxfUFdEOiAke01ZU1FMX1JPT1RfUEFTU1dPUkR9XG4gICAgICBSRUFMTV9BRERSRVNTOiAke1JFQUxNX0FERFJFU1N9XG4gICAgZW50cnlwb2ludDogW1wiL2Jpbi9zaFwiLCBcIi1jXCJdXG4gICAgY29tbWFuZDpcbiAgICAgIC0gPi1cbiAgICAgICAgbXlzcWwgLS1ob3N0PWF6ZXJvdGhjb3JlLWRhdGFiYXNlIC0tdXNlcj1yb290XG4gICAgICAgIC0tZXhlY3V0ZT1cIlVQREFURSBhY29yZV9hdXRoLnJlYWxtbGlzdFxuICAgICAgICBTRVQgbmFtZSA9ICdBemVyb3RoQ29yZScsIGFkZHJlc3MgPSAnJCR7UkVBTE1fQUREUkVTU30nLFxuICAgICAgICBsb2NhbEFkZHJlc3MgPSAnMTI3LjAuMC4xJywgbG9jYWxTdWJuZXRNYXNrID0gJzI1NS4yNTUuMjU1LjAnLCBwb3J0ID0gODA4NVxuICAgICAgICBXSEVSRSBpZCA9IDE7XCJcbiAgICBkZXBlbmRzX29uOlxuICAgICAgYXplcm90aGNvcmUtZGF0YWJhc2U6XG4gICAgICAgIGNvbmRpdGlvbjogc2VydmljZV9oZWFsdGh5XG4gICAgICBhemVyb3RoY29yZS1kYi1pbXBvcnQ6XG4gICAgICAgIGNvbmRpdGlvbjogc2VydmljZV9jb21wbGV0ZWRfc3VjY2Vzc2Z1bGx5XG5cbiAgYXplcm90aGNvcmUtYXV0aDpcbiAgICBpbWFnZTogYWNvcmUvYWMtd290bGstYXV0aHNlcnZlcjoxNy4wLjAtZGV2XG4gICAgcmVzdGFydDogdW5sZXNzLXN0b3BwZWRcbiAgICB0dHk6IHRydWVcbiAgICBlbnZpcm9ubWVudDpcbiAgICAgIEFDX0xPR1NfRElSOiAvYXplcm90aGNvcmUvZW52L2Rpc3QvbG9nc1xuICAgICAgQUNfVEVNUF9ESVI6IC9hemVyb3RoY29yZS9lbnYvZGlzdC90ZW1wXG4gICAgICBBQ19MT0dJTl9EQVRBQkFTRV9JTkZPOiBhemVyb3RoY29yZS1kYXRhYmFzZTszMzA2O3Jvb3Q7JHtNWVNRTF9ST09UX1BBU1NXT1JEfTthY29yZV9hdXRoXG4gICAgcG9ydHM6XG4gICAgICAtIFwiMzcyNDozNzI0L3RjcFwiXG4gICAgdm9sdW1lczpcbiAgICAgIC0gYXplcm90aGNvcmUtY29uZmlnOi9hemVyb3RoY29yZS9lbnYvZGlzdC9ldGNcbiAgICAgIC0gYXplcm90aGNvcmUtbG9nczovYXplcm90aGNvcmUvZW52L2Rpc3QvbG9nc1xuICAgIGRlcGVuZHNfb246XG4gICAgICBhemVyb3RoY29yZS1yZWFsbS1jb25maWc6XG4gICAgICAgIGNvbmRpdGlvbjogc2VydmljZV9jb21wbGV0ZWRfc3VjY2Vzc2Z1bGx5XG5cbiAgYXplcm90aGNvcmU6XG4gICAgaW1hZ2U6IGFjb3JlL2FjLXdvdGxrLXdvcmxkc2VydmVyOjE3LjAuMC1kZXZcbiAgICByZXN0YXJ0OiB1bmxlc3Mtc3RvcHBlZFxuICAgIHN0ZGluX29wZW46IHRydWVcbiAgICB0dHk6IHRydWVcbiAgICBzdG9wX2dyYWNlX3BlcmlvZDogMm1cbiAgICBlbnZpcm9ubWVudDpcbiAgICAgIEFDX0RBVEFfRElSOiAvYXplcm90aGNvcmUvZW52L2Rpc3QvZGF0YVxuICAgICAgQUNfTE9HU19ESVI6IC9hemVyb3RoY29yZS9lbnYvZGlzdC9sb2dzXG4gICAgICBBQ19MT0dJTl9EQVRBQkFTRV9JTkZPOiBhemVyb3RoY29yZS1kYXRhYmFzZTszMzA2O3Jvb3Q7JHtNWVNRTF9ST09UX1BBU1NXT1JEfTthY29yZV9hdXRoXG4gICAgICBBQ19XT1JMRF9EQVRBQkFTRV9JTkZPOiBhemVyb3RoY29yZS1kYXRhYmFzZTszMzA2O3Jvb3Q7JHtNWVNRTF9ST09UX1BBU1NXT1JEfTthY29yZV93b3JsZFxuICAgICAgQUNfQ0hBUkFDVEVSX0RBVEFCQVNFX0lORk86IGF6ZXJvdGhjb3JlLWRhdGFiYXNlOzMzMDY7cm9vdDske01ZU1FMX1JPT1RfUEFTU1dPUkR9O2Fjb3JlX2NoYXJhY3RlcnNcbiAgICBwb3J0czpcbiAgICAgIC0gXCI4MDg1OjgwODUvdGNwXCJcbiAgICB2b2x1bWVzOlxuICAgICAgLSBhemVyb3RoY29yZS1jb25maWc6L2F6ZXJvdGhjb3JlL2Vudi9kaXN0L2V0Y1xuICAgICAgLSBhemVyb3RoY29yZS1sb2dzOi9hemVyb3RoY29yZS9lbnYvZGlzdC9sb2dzXG4gICAgICAtIGF6ZXJvdGhjb3JlLWNsaWVudC1kYXRhOi9hemVyb3RoY29yZS9lbnYvZGlzdC9kYXRhOnJvXG4gICAgZGVwZW5kc19vbjpcbiAgICAgIGF6ZXJvdGhjb3JlLXJlYWxtLWNvbmZpZzpcbiAgICAgICAgY29uZGl0aW9uOiBzZXJ2aWNlX2NvbXBsZXRlZF9zdWNjZXNzZnVsbHlcbiAgICAgIGF6ZXJvdGhjb3JlLWNsaWVudC1kYXRhOlxuICAgICAgICBjb25kaXRpb246IHNlcnZpY2VfY29tcGxldGVkX3N1Y2Nlc3NmdWxseVxuXG52b2x1bWVzOlxuICBhemVyb3RoY29yZS1kYXRhYmFzZTpcbiAgYXplcm90aGNvcmUtY2xpZW50LWRhdGE6XG4gIGF6ZXJvdGhjb3JlLWNvbmZpZzpcbiAgYXplcm90aGNvcmUtbG9nczoiLAogICJjb25maWciOiAiW3ZhcmlhYmxlc11cbm15c3FsX3Jvb3RfcGFzc3dvcmQgPSBcIiR7cGFzc3dvcmQ6MzJ9XCJcbnJlYWxtX2FkZHJlc3MgPSBcIiR7ZG9tYWlufVwiXG5cbltjb25maWddXG5kb21haW5zID0gW11cbm1vdW50cyA9IFtdXG5lbnYgPSBbXG4gIFwiTVlTUUxfUk9PVF9QQVNTV09SRD0ke215c3FsX3Jvb3RfcGFzc3dvcmR9XCIsXG4gIFwiUkVBTE1fQUREUkVTUz0ke3JlYWxtX2FkZHJlc3N9XCIsXG5dIgp9

Configuration

The exact Docker Compose and template configuration this template deploys.

Instructions

AzerothCore setup

Before deploying

AzerothCore's published server images currently support amd64 hosts only.

AzerothCore uses raw TCP connections rather than HTTP. Make sure TCP ports 3724 (authentication) and 8085 (world server) are free on the Dokploy host and allowed through its firewall.

The template generates REALM_ADDRESS with Dokploy's domain helper. Verify that this hostname resolves publicly to the Dokploy server. If it does not, replace REALM_ADDRESS in the service environment with the server's public IP address or another public DNS name, then redeploy.

First startup

The first deployment downloads the client data and imports the authentication, character, and world databases. This can take several minutes. The azerothcore-client-data, azerothcore-db-import, and azerothcore-realm-config containers are initialization jobs and should exit successfully after completing their work.

Create the first game account

After the azerothcore world server is running, attach to its console from the Dokploy host:


bash

Create an account and grant it administrator permissions:


text

Detach without stopping the server by pressing Ctrl-p, then Ctrl-q.

Connect a 3.3.5a client

Set the client's Data/<locale>/realmlist.wtf file to the same hostname or IP stored in REALM_ADDRESS:


text

Restart the client, sign in with the account created above, and select the AzerothCore realm. If authentication works but the realm connection fails, confirm that TCP port 8085 is reachable and that REALM_ADDRESS points to the Dokploy host.

For updates, backups, configuration, and troubleshooting, see the AzerothCore Docker documentation.