Skip to content

Getting Started

Jacob Bowen edited this page Mar 8, 2026 · 1 revision

Getting Started

This page walks you through everything you need to do after installing AzerothPanel for the first time.


1. Log In

Open the panel URL (default http://localhost) and log in with the credentials you set in backend/.env:

  • Username: value of PANEL_ADMIN_USER (default admin)
  • Password: value of PANEL_ADMIN_PASSWORD

You will land on the Dashboard after a successful login.


2. Configure Settings

Before any panel features will work, you must configure how AzerothPanel connects to AzerothCore. Navigate to Settings in the sidebar.

AzerothCore Paths

Field What to enter
AC Path Absolute path to your AzerothCore directory (e.g. /opt/azerothcore)
Build Dir CMake build directory relative to AC Path (default build)
Data Dir Path containing DBC/Maps/VMaps/MMaps (default <AC_PATH>/data)
Worldserver Binary Full path to worldserver executable
Authserver Binary Full path to authserver executable

MySQL — Three Databases

You need to fill in connection details separately for the auth, world, and characters databases:

Field Typical value
Host 127.0.0.1
Port 3306
User Your MySQL user for AzerothCore
Password MySQL password
Database acore_auth / acore_world / acore_characters

Click Test Connection after filling each section to verify connectivity.

SOAP

Field Value
Host 127.0.0.1 (must match SOAP.IP in worldserver.conf)
Port 7878 (must match SOAP.Port)
User In-game GM account (level 3)
Password That account's password

SOAP must be enabled in worldserver.conf:

SOAP.Enabled = 1
SOAP.IP      = 127.0.0.1
SOAP.Port    = 7878

Click Save Settings when done. Changes take effect immediately — no restart required.


3. Extract or Download Client Data

Before the servers can run, AzerothCore needs DBC, Maps, VMaps, and MMaps files. Navigate to Data Extraction.

Option A — Download pre-extracted data (easiest)

Click Download Data. AzerothPanel fetches the pre-built archive from AzerothCore releases (~1.5 GB). Takes 2–10 minutes depending on your connection. No WoW client required.

Option B — Extract from local client

If you have a WoW 3.3.5a (12340) client:

  1. Set CLIENT_PATH in your root .env to point to the client directory.
  2. Restart the panel containers (make docker-restart).
  3. On the Data Extraction page, choose which data types to extract.
  4. Note: MMaps generation takes 30–60 minutes.

4. Start the Servers

Go to Server Control and click Start Worldserver and Start Authserver. The Dashboard will update to show their running status and the online player count.


5. Verify Everything Works

  • Dashboard: worldserver and authserver show as "Running".
  • Log Viewer: Select worldserver source — you should see live log output.
  • Player Management: Connect a WoW client and log in; you should appear in the online players list.
  • SOAP: On the Server Control page, type server info into the command box and submit — you should get a response.

Next Steps

Clone this wiki locally