Skip to content

Updating CraftPanel

From the dashboard

Section titled “From the dashboard”

When a new release is out, a notice appears in the sidebar and under Settings → Security & about. Click Update now to see the release notes and which servers are affected, then confirm.

CraftPanel runs the installer outside its own process, follows it through the restart and reloads into the new version with a What’s new summary. If anything fails, the previous version is restored and the dashboard tells you what went wrong.

This works for installs made with the one-line installers. Only Owners and Administrators can start an update, and it is recorded in the audit log.

From the command line

Section titled “From the command line”

Run the install command again, or:

Terminal window
sudo /opt/craftpanel/update.sh

What happens to running servers

Section titled “What happens to running servers”
  • Dashboard-only updates (most releases) replace the dashboard while Minecraft keeps running. Players stay connected.
  • Runtime updates change the service that runs Minecraft. They save and stop running servers once and need your explicit approval; servers with auto-start come back afterwards.

Either way, the database is snapshotted first. A failed update restores the previous application and database.

Offline updates

Section titled “Offline updates”

Put craftpanel-vX.Y.Z.tar.gz and its SHA256SUMS into a folder and set CRAFTPANEL_RELEASE_DIR to that folder in your settings file. The dashboard then offers the newest archive from there, and the installers install from it.

The update check itself only reads the latest release from GitHub. Turn it off in Settings or with CRAFTPANEL_UPDATE_CHECK=false.