Live demoRequest access
MU-CMS/Help/Troubleshooting

Fix it fast.

The common problems and their fixes. Nothing here needs you to share a key or a password with anyone.

01

Installer FAIL lines

The installer stops before changing anything when a preflight check fails. Fix the line, then run it again (add -Check to test without installing).

ADMINISTRATORRight-click PowerShell and choose Run as administrator, then run the installer again.
SQLCMD AVAILABLEInstall the SQL Server command-line tools (sqlcmd) from Microsoft, open a new PowerShell window and retry.
SQL SERVER REACHABLECheck -SqlInstance. For a named instance use .\NAME. Your Windows account must be able to sign in to SQL Server.
DATABASE PRESENTCheck -Database. IGCN servers usually use MuOnline.
SQL SERVER TCP PORTEnable TCP/IP for the instance in SQL Server Configuration Manager, restart the SQL Server service, then retry.
OUTBOUND HTTPSAllow outbound traffic to the endpoint staff gave you. No inbound port is needed.
FREE DISKFree at least 50 MB on the install drive or pass -InstallDir on another drive.
AGENT FILESKeep mucms-agent.exe and agent-grants.sql in the same folder as the installer.
02

Agent shows offline

Check the background task is running:Get-ScheduledTask -TaskName 'MU CMS Agent' | Select-Object State

Run the self-test. It reads your database once and prints totals:& 'C:\ProgramData\MuCMS\mucms-agent.exe' -config 'C:\ProgramData\MuCMS\agent-config.json' -selftest

To see the agent's own messages, stop the task and run it in the window (Ctrl+C to stop), then start the task again:Stop-ScheduledTask -TaskName 'MU CMS Agent' & 'C:\ProgramData\MuCMS\mucms-agent.exe' -config 'C:\ProgramData\MuCMS\agent-config.json' Start-ScheduledTask -TaskName 'MU CMS Agent'

Good to know: the agent only connects outbound; if the self-test works but it never comes online, check outbound traffic to your endpoint.
03

Players see a maintenance page

Web features pause when a licence has expired and its grace period is over (48 hours unless staff set another value on the licence), or when staff suspended it. The game server keeps running.

Fix: renew or ask staff on Discord; web features come back as soon as the licence is valid again.
04

Rankings or pages are empty

During install, any table your server does not have is skipped with a WARN line (for example a server without Gens or Castle Siege data). Pages that need that table stay empty.

Fix: send us the WARN lines on Discord; we tell you whether your files store that data elsewhere.
05

Theme change not showing

Player sites pick up a saved theme within 30 seconds. Reload the page after that.

Good to know: visitors who chose another theme in the switcher keep their choice; colour and font changes apply to your default theme.
06

Moved to a new machine

A licence is bound to one machine. After a move the old binding refuses the new machine: ask staff to release it, then run the installer on the new machine with the same licence key.

Remove the old install: run the installer with -Uninstall. It removes the task and keeps your files; it prints how to drop the SQL login.
Still stuck?

Send the lines.

Send the PASS/FAIL or WARN lines on Discord. They contain no keys or passwords.