A complete containerized deployment of AzerothCore WoW 3.3.5a (Wrath of the Lich King) private server with hundreds of supported modules and intelligent automations to allow for easy setup, deployment and management.
- Quick Start
- What You Get
- Getting Started → docs/GETTING_STARTED.md
- Using Pre-Built Images → docs/PREBUILT_IMAGES.md
- Complete Module Catalog → docs/MODULES.md
- Management & Operations → docs/GETTING_STARTED.md
- Advanced Configuration → docs/ADVANCED.md
- Custom NPCs Guide → docs/NPCS.md
- Script Reference → docs/SCRIPTS.md
- CI/CD & Pre-Built Images → docs/CICD.md
- Troubleshooting → docs/TROUBLESHOOTING.md
- Credits & Next Steps
- Docker with Docker Compose 2
- 16GB+ RAM and 64GB+ storage
- Linux/macOS/WSL2 Fully tested with Ubuntu 24.04 - Debian 12 might work but permissions can require manual intervention
# 1. Get the code
git clone https://github.com/uprightbass360/AzerothCore-RealmMaster.git
cd AzerothCore-RealmMaster
# 2. Configure your server
./setup.sh
# 3. Deploy
./deploy.sh # Always required - Supports ssh remote deploy or local
./status.sh # Optional - Shows health and accesibility of all containers and current user dataFirst deployment takes 30-60 minutes for database setup and client data download. Subsequent starts are much faster.
Skip the build process and deploy with pre-built Docker images:
# 1. Clone the repository
git clone https://github.com/uprightbass360/AzerothCore-RealmMaster.git
cd AzerothCore-RealmMaster
# 2. Use pre-built configuration
cp .env.prebuilt .env
# 3. Edit .env and set DOCKERHUB_USERNAME
# 4. Deploy
./deploy.shPre-built images include the RealmMaster profile (32 modules) and are automatically built nightly. See docs/PREBUILT_IMAGES.md for details.
Note: Remote deployments require one additional step after migration - see Remote Deployment Guide.
See Getting Started for detailed walkthrough.
- AzerothCore 3.3.5a - WotLK server application with 348 modules in the manifest (221 currently supported)
- MySQL 8.0 - Database with intelligent initialization and restoration
- Smart Module System - Automated module management and source builds
- phpMyAdmin - Web-based database administration
- Keira3 - Game content editor and developer tools
- Intelligent Database Setup - Smart backup detection, restoration, and conditional schema import (details in docs/DATABASE_MANAGEMENT.md)
- Restore-Aware Backups & SQL - Restore-aware SQL staging and snapshot safety checks keep modules in sync after restores (docs/DATABASE_MANAGEMENT.md)
- Module Integration - Automatic source builds when C++ modules are enabled
- Service Orchestration - Profile-based deployment (standard/playerbots/modules)
Quick Overview:
- Clone repository →
./setup.sh→./build.sh(if needed) →./deploy.sh - Create admin account and connect your WoW 3.3.5a client
- Access management tools at http://localhost:8081 (phpMyAdmin) and http://localhost:4201 (Keira3)
For complete local and remote deployment guides, see docs/GETTING_STARTED.md.
Choose from hundreds of enhanced modules spanning automation, quality-of-life improvements, gameplay enhancements, PvP features, and more. The manifest contains 348 modules (221 marked supported/active); the default RealmMaster preset enables 33 that are exercised in testing. All modules are automatically downloaded, configured, and integrated during deployment when selected.
Want a shortcut? Use a preset (RealmMaster, suggested-modules, playerbots-suggested-modules, azerothcore-vanilla, playerbots-only, all-modules) from config/module-profiles/—see docs/GETTING_STARTED.md#module-presets.
Popular Categories:
- Automation - Playerbots, AI chat, level management
- Quality of Life - Solo LFG, AOE looting, auto-revive
- Gameplay - Autobalance, challenge modes, hardcore mode
- Services - Transmog, profession NPCs, talent templates
Browse the complete catalog with descriptions at docs/MODULES.md.
The server includes 14 custom NPCs spanning services, buffs, PvP, and guild support. Full spawn commands, coordinates, and functions are in docs/NPCS.md.
For common workflows, management commands, and database operations, see docs/GETTING_STARTED.md. For script details (including module manifest auto-sync), see docs/SCRIPTS.md.
For architecture details, storage structure, build system, and advanced customization, see docs/ADVANCED.md.
For comprehensive documentation of all deployment scripts, management commands, and automation tools, see docs/SCRIPTS.md.
For diagnostic procedures, common issues, and backup system documentation, see docs/TROUBLESHOOTING.md.
This project builds upon:
- AzerothCore - Core server application
- AzerothCore Module Community - Enhanced gameplay modules
- acore-docker - Inspiration for containerized deployment
- mod-playerbots - Advanced playerbot functionality
- All module creators - Making amazing things every day
- AzerothCore Discord - Join the community for support and discussions
- GitHub Issues - Report build or deployment issues here
- ✅ Fully Automated Setup - Interactive configuration and deployment
- ✅ Intelligent Module System - Automatic source builds and profile selection
- ✅ Automated Backups - Health checks, scheduled backups, and monitoring
- ✅ Docker-Based - Containerized deployment for easy setup and portability
- ✅ Comprehensive Documentation - Clear setup and troubleshooting guides
For detailed server administration, monitoring, backup configuration, and performance tuning, see docs/GETTING_STARTED.md.
- Create admin account - Attach to worldserver and create a GM user (commands in docs/GETTING_STARTED.md#post-installation-steps).
- Point your client - Update
realmlist.wtfto your host/ports (defaults in the same section above). - Open services - phpMyAdmin and Keira3 URLs/ports are listed in docs/GETTING_STARTED.md#post-installation-steps.