Skip to content

Server Control

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

Server Control

The Server Control page lets you manage the worldserver and authserver processes, execute GM commands via SOAP, and view live host system information.


Starting and Stopping Servers

The panel exposes individual Start, Stop, and Restart buttons for both the worldserver and authserver.

Action What happens
Start Launches the binary under the path configured in Settings, capturing stdout/stderr to the log file.
Stop Sends SIGTERM to the process; waits for a graceful shutdown.
Restart Stop followed by Start.

Tip: Start the authserver first, then the worldserver. The worldserver connects to the auth DB on startup.

The current status (Running / Stopped) and the online player count are refreshed automatically every few seconds on the Dashboard and Server Control page.


Executing GM Commands via SOAP

The Command box lets you run any worldserver GM command as if you were at the worldserver console. Examples:

Command Effect
server info Returns server version and player count
server shutdown 60 Schedules a shutdown in 60 seconds
account create bob password123 Creates a new account
ban account cheater 30d Cheating Bans cheater for 30 days
learn all_gm Teaches all GM spells to the targeted player
tele name PlayerName Stormwind Teleports a player to Stormwind

The SOAP interface must be enabled in worldserver.conf and credentials must be configured in Settings.


Server Announcements

The Announce field broadcasts a message to all currently online players as a yellow server message. It uses the SOAP server announce command internally.


Host System Information

The Server Info panel displays real-time host metrics:

  • CPU usage (%)
  • RAM used / total
  • System uptime
  • Disk usage for the AzerothCore data directory

This information is polled from the host at page load and on each status refresh.


API Endpoints

Method Path Description
GET /api/v1/server/status Running status + player count
POST /api/v1/server/worldserver/start Start worldserver
POST /api/v1/server/worldserver/stop Stop worldserver
POST /api/v1/server/worldserver/restart Restart worldserver
POST /api/v1/server/authserver/start Start authserver
POST /api/v1/server/authserver/stop Stop authserver
POST /api/v1/server/authserver/restart Restart authserver
POST /api/v1/server/command Execute a GM command via SOAP
POST /api/v1/server/announce Send a global announcement
GET /api/v1/server/info Host CPU / memory / uptime

See API-Reference for full request/response schemas.


Troubleshooting

Server won't start

  • Check that the binary path in Settings is correct and the file is executable.
  • Check that the Data directory contains DBC/Maps files (see Data-Extraction).
  • Open the Log-Viewer and select the worldserver log to see startup errors.

SOAP commands return an error

  • Verify SOAP.Enabled = 1 in worldserver.conf.
  • Confirm the GM account credentials in Settings match a level-3 account.
  • The worldserver must be running for SOAP to work.

Online player count shows 0 when players are connected

  • Check SOAP connectivity — player count comes from a SOAP server info query.

See Troubleshooting for more.

Clone this wiki locally