STYGION Documentation Search the docs

When something does not work

The server will not boot, players cannot connect, the console is quiet — where to look, and in what order.

Panel 0.4.0 Updated 3 min read

This page is older than Panel 0.4.0, released 2 September 2026. Something may have changed since.

On this page 6 parts
  1. The server will not boot
  2. Players cannot connect, but the server is up
  3. The console shows nothing
  4. I type a command and nothing happens
  5. A panel update failed
  6. Before you write to support

When something does not work

The order is always the same: what the console says, then what the panel says, and only then the machine.

The server will not boot

#

Open the console and read the first ten lines after the banner. The answer is almost always there.

What you see What it is
UnsupportedClassVersionError Wrong Java. Change the image.
-XmxM in the command A misspelled variable. Unknown ones render empty.
Permission denied on a file Ownership. Files → Change permissions.
Address already in use Something else holds the port. Allocations.
Nothing for a long time after the banner A modpack unpacking. A minute is normal.
EULA eula.txt, in files.

Players cannot connect, but the server is up

#

The panel opens a port on the machine, and there its responsibility ends. Work from the inside out:

  1. Is the server listening? The console should say Done and a port.
  2. Is the allocation right? Network — the first one is what fills SERVER_PORT.
  3. The machine's firewall. The installer opened the panel's ports, not the game's.
  4. The router. A port forward that did not come back after a reboot looks exactly like a server that is down.
  5. DNS. A domain is not a route. If the port does not work, a domain will not fix it.

The console shows nothing

#

First, whether the server is actually running — the state is beside its name. Then the status at the top right of the console: connected, connecting…, disconnected.

A disconnected that does not come back is usually a reverse proxy that does not pass WebSockets. The panel pings every 25 seconds; a proxy with a shorter idle timeout will still close it.

An empty console for a running server that something other than the panel started is normal only until the next restart — the panel adopts running servers.

I type a command and nothing happens

#

Before 0.3.3 there was one usual cause: the panel had restarted in the meantime and that closed the server's input. Since 0.3.3 it does not happen — but a server still running from an older version is still in that state. Stop it and start it once and it moves over by itself.

When a command does not arrive, the panel says so. The > command line appears only once the server has taken it.

A panel update failed

#

The message is the real one. Two usual causes: nowhere to write (the directory holding the binary must belong to the user the panel runs as) and the build is gone (a channel points at a withdrawn release for a while). More under Updating.

Before you write to support

#

Send this straight away — it is exactly what we would ask for:

  • the panel's version (stygion-core --version),
  • what you pressed and what happened,
  • the first twenty lines of the console after the start,
  • whether the server is on the master or on a node.

Did this page help?

Opens the feedback panel with this page attached. It lands in the same queue as everything else.