Scripts Directory
This directory contains deployment, configuration, and management scripts for the AzerothCore Docker deployment.
Core Scripts
🚀 Setup & Deployment
setup-server.sh- Interactive server setup wizard (recommended for new users)deploy-and-check.sh- Automated deployment and comprehensive health check scriptauto-post-install.sh- Automated post-installation configuration
🔧 Configuration & Management
configure-modules.sh- Module configuration analysis and guidance toolsetup-eluna.sh- Lua scripting environment setupupdate-realmlist.sh- Update server address in realmlist configurationupdate-config.sh- Configuration file updates and management
💾 Backup & Restore
backup.sh- Manual database backupbackup-hourly.sh- Hourly automated backup scriptbackup-daily.sh- Daily automated backup scriptrestore.sh- Database restoration from backup
🧹 Maintenance
cleanup.sh- Resource cleanup script with multiple cleanup levelsrebuild-with-modules.sh- Rebuild containers with module compilationtest-local-worldserver.sh- Local worldserver testing
📚 Documentation
DEPLOYMENT.md- Complete documentation for deployment scriptsCLEANUP.md- Complete documentation for cleanup scripts
Quick Usage
🆕 First-Time Setup (Recommended)
# Interactive setup wizard
./scripts/setup-server.sh
🔧 Module Configuration Analysis
# Check module configuration requirements
./scripts/configure-modules.sh
🎮 Lua Scripting Setup
# Setup Eluna scripting environment
./scripts/setup-eluna.sh
🩺 Health Checks & Deployment
Run Health Check on Current Deployment
cd scripts
./deploy-and-check.sh --skip-deploy
Full Deployment with Health Checks
cd scripts
./deploy-and-check.sh
Quick Health Check (Basic Tests Only)
cd scripts
./deploy-and-check.sh --skip-deploy --quick-check
🧹 Cleanup Resources
cd scripts
# Stop containers only (safe)
./cleanup.sh --soft
# Remove containers + networks (preserves data)
./cleanup.sh --hard
# Complete removal (DESTROYS ALL DATA)
./cleanup.sh --nuclear
# Dry run to see what would happen
./cleanup.sh --hard --dry-run
💾 Backup & Restore Operations
# Manual backup
./scripts/backup.sh
# Restore from backup
./scripts/restore.sh backup_filename.sql
# Setup automated backups (already configured in containers)
# Hourly: ./scripts/backup-hourly.sh
# Daily: ./scripts/backup-daily.sh
Features
🚀 Setup & Deployment Features
✅ Interactive Setup Wizard: Guided configuration for new users ✅ Automated Server Deployment: Complete three-layer deployment system ✅ Module Management: Automated installation and configuration of 13 enhanced modules ✅ Post-Install Automation: Automatic database setup, realmlist configuration, and service restart
🔧 Configuration Features
✅ Module Analysis: Identifies missing configurations and requirements ✅ Lua Scripting Setup: Automated Eluna environment with example scripts ✅ Realmlist Management: Dynamic server address configuration ✅ Config File Management: Automated .conf file generation from .conf.dist templates
🩺 Health & Monitoring Features
✅ Container Health Validation: Checks all core containers ✅ Port Connectivity Tests: Validates all external ports ✅ Web Service Verification: HTTP response and content validation ✅ Database Validation: Schema and realm configuration checks ✅ Comprehensive Reporting: Color-coded status with detailed results
💾 Backup & Maintenance Features
✅ Automated Backups: Scheduled hourly and daily database backups ✅ Manual Backup/Restore: On-demand backup and restoration tools ✅ Multi-Level Cleanup: Safe, hard, and nuclear cleanup options ✅ Container Rebuilding: Module compilation and container rebuilding support
Script Usage Examples
First-Time Server Setup
# Complete guided setup (recommended)
./scripts/setup-server.sh
# Follow the interactive prompts to configure:
# - Server network settings
# - Storage locations
# - Database passwords
# - Module selections
Post-Installation Configuration
# Analyze and configure modules
./scripts/configure-modules.sh
# Setup Lua scripting environment
./scripts/setup-eluna.sh
# Update server address after IP changes
./scripts/update-realmlist.sh new.server.address
Maintenance Operations
# Health check existing deployment
./scripts/deploy-and-check.sh --skip-deploy
# Clean restart (preserves data)
./scripts/cleanup.sh --hard
./scripts/deploy-and-check.sh
# Backup before major changes
./scripts/backup.sh
Configuration Variables
The scripts work with the updated environment variable names:
MYSQL_EXTERNAL_PORT(database port)AUTH_EXTERNAL_PORT(authentication server port)WORLD_EXTERNAL_PORT(world server port)SOAP_EXTERNAL_PORT(SOAP API port)MYSQL_ROOT_PASSWORD(database root password)SERVER_ADDRESS(external server address)STORAGE_ROOT(data storage location)
For complete documentation, see DEPLOYMENT.md and CLEANUP.md.