Health

What the Health page shows#

The Health page collects automated checks that the panel runs against your server. As the page explains at the top, these checks run automatically when your server starts and flag anything that might cause problems. They are recommendations, so you can ignore any that do not apply to your setup. Nothing here changes your server on its own, and acting on a finding is always your call.

You reach the page from the Health item in the server sidebar, which carries a heartbeat icon. When the checks turn up something worth your attention, a small count sits next to that sidebar item so you can see there is something to look at without opening the page. The count adds up every actionable finding, and its colour follows the worst one in the list, so a red badge means there is at least one Critical item waiting. Plain notes do not raise the count, so the badge only lights up for findings that need a look.

Note: The Health page is read only. It needs the health.read permission, so if a subuser cannot see the page, check their access on the users and permissions list.

Reading a finding#

Each finding is a single row. On the left sits an icon tinted to its severity, then a bold title that names the condition. Below the title, a finding can carry a longer line of detail that explains what was found, and when the check points at a specific file, that file path appears under the detail in a monospaced font so you can find it exactly. A mods scan, for example, can name the file under /mods that tripped the check. On the right of the row, a small pill repeats the severity in words.

Findings are sorted worst first, so the most serious items always sit at the top of the list and you do not have to hunt for them.

The four severities#

Every finding is labelled with one of four severities. The pill on the row spells out which one it is:

  • Critical is the most serious. These findings are the ones most likely to stop your server working or behaving as expected, so look at them first.
  • Warning marks something that needs attention but is less urgent than a Critical finding.
  • Advisory is a softer heads up. It is worth knowing about, but it is unlikely to break anything on its own.
  • Note is purely informational. Notes do not add to the sidebar count, so they sit on the page as context rather than as something you need to act on.

Critical, Warning, and Advisory all raise the sidebar count; Note findings do not. That is why the badge can be quiet even when the page still has rows on it.

Acting on a finding#

A finding tells you what was found, but you fix it by going to the part of the panel it points at. If a finding names a file, open the file manager and go to that path to take a look. If it concerns the way your server launches, head to startup, and if it relates to the content you have added, check your mods and plugins.

Because the findings are recommendations, you are free to leave any that do not apply to your setup. Nothing on this page forces a change, and acting on a finding never happens automatically.

Clearing findings and refreshing#

The checks run when your server starts, so the way to refresh the page is to restart your server and come back. After it next starts, the list is rebuilt from the latest run, and anything you have since fixed drops off while any new condition appears. There is no manual clear button; resolving the underlying cause and restarting is what makes a finding go away.

When the checks find nothing, the page shows a green tick with No issues found and a line noting that the automated checks did not find anything to flag, and that new findings will appear after your server next starts. A clean page is meant to read as confirmation, not as something missing.

You can restart your server from the console whenever you want to run the checks again.