Skip to content

Worlds, files and backups

The Worlds tab lists a server’s worlds with their size. You can:

  • Create a new world with its own seed and type, and select which one the server loads.
  • Import a world from a .zip (for example from singleplayer or another host): drop the file anywhere on the tab or press Import. CraftPanel looks into the archive first, shows which dimensions it holds, suggests a free name and can make it the active world right away. Zip the world’s folder (the one with level.dat); a world inside one or two wrapper folders, or Paper’s world, world_nether and world_the_end side by side, work too. Nothing existing is overwritten.
  • Export a world as a .zip download. The server may keep running; CraftPanel saves the world first. The archive contains the Nether and End and imports back into any CraftPanel.
  • Delete a world; CraftPanel makes a backup first.

The Files tab is a file manager for the server folder: browse, edit text files, upload (also zips, which you can extract), download and delete. Every path is confined to the server’s directory; symlinks are neither listed nor followed.

Configuration you change often has a dedicated editor instead: Settings validates server.properties and shows the game rules your exact Minecraft version supports.

Backups are zip archives of the whole server folder. CraftPanel makes them consistent while the server runs: it pauses world saving, flushes the world to disk, archives it and resumes saving.

  • Create one from the Backups tab, or schedule them under Automation.
  • Every backup is verified after it’s written.
  • Restore replaces the server’s worlds and configuration with the backup. CraftPanel verifies the archive first and creates a safety backup of the current state automatically.
  • Old backups can be pruned on a schedule, keeping the newest n.
  • Settings → Backups sets where backups are stored, for example a second disk.

The global Backups page lists the backups of all servers.

Server backups cover Minecraft. To back up the panel (accounts, settings, schedules), stop both services and copy the whole data directory, together with your settings file (/etc/craftpanel/craftpanel.env or config.env) and any TLS certificates. See maintenance.