A complete containerized deployment of AzerothCore WoW 3.3.5a (Wrath of the Lich King) private server with 93+ enhanced modules and intelligent automation.

Quick Start
What You Get
Getting Started → docs/GETTING_STARTED.md
Complete Module Catalog → docs/MODULES.md
Management & Operations → docs/GETTING_STARTED.md
Advanced Configuration → docs/ADVANCED.md
Script Reference → docs/SCRIPTS.md
Troubleshooting → docs/TROUBLESHOOTING.md
Credits & Next Steps

Quick Start

Prerequisites

Docker with Docker Compose
16GB+ RAM and 32GB+ storage
Linux/macOS/WSL2 (Windows with WSL2 recommended)

Three Simple Steps

# 1. Get the code
git clone https://github.com/uprightbass360/AzerothCore-RealmMaster.git
cd AzerothCore-RealmMaster

# 2. Configure your server
./setup.sh

# 3. Deploy (if using modules/playerbots) and deploy
./build.sh    # Optional - Will be triggered if required in deploy. c++ modules require compilation
./deploy.sh   # Always required - Supports ssh remote deploy or local
./status.sh   # Optional - Shows health and accesibility of all containers and current user data

First deployment takes 30-60 minutes for database setup and client data download. Subsequent starts are much faster.

See Getting Started for detailed walkthrough.

What You Get

✅ Core Server Components

AzerothCore 3.3.5a - WotLK server application with 93+ enhanced modules
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

✅ Automated Configuration

Intelligent Database Setup - Smart backup detection, restoration, and conditional schema import
Backup Management - Automated hourly/daily backups with intelligent restoration
Module Integration - Automatic source builds when C++ modules are enabled
Service Orchestration - Profile-based deployment (standard/playerbots/modules)

Getting Started

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.

Complete Module Catalog

Choose from 93+ enhanced modules spanning automation, quality-of-life improvements, gameplay enhancements, PvP features, and more. All modules are automatically downloaded, configured, and integrated during deployment.

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.

Management & Operations

For common workflows, management commands, and database operations, see docs/GETTING_STARTED.md.

Advanced Configuration

For architecture details, storage structure, build system, and advanced customization, see docs/ADVANCED.md.

Script Reference

For comprehensive documentation of all deployment scripts, management commands, and automation tools, see docs/SCRIPTS.md.

Troubleshooting

For diagnostic procedures, common issues, and backup system documentation, see docs/TROUBLESHOOTING.md.

Credits & Next Steps

Project Credits

This project builds upon:

AzerothCore - Core server application
AzerothCore Module Community - Enhanced gameplay modules

Key Features

✅ 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

Next Steps After Installation

Essential First Steps:

Create admin account: docker attach ac-worldserver → account create admin password → account set gmlevel admin 3 -1
Test your setup: Connect with WoW 3.3.5a client using set realmlist 127.0.0.1
Access web tools: phpMyAdmin (port 8081) and Keira3 (port 4201)

For detailed server administration, monitoring, backup configuration, and performance tuning, see docs/GETTING_STARTED.md.

README.md

AzerothCore RealmMaster

Table of Contents