Skip to main content

Export/Import Instance

Exporting Instances:

A feature in the control panel allows you to export an instance to download to your computer, in which you can restore them later on.

  • Visit the Control Panel > Minecraft: Java Edition > Instance sub-menus.
  • Click Export Instance and wait for it to complete, this could take a few minutes, or longer (hours) depending on the size of your installation.
  • You will get a pop up in the panel with a URL to download your instance file.
    - If for some reason this popup does not show, you can find the URL by going to Account > Security then you should see an entry with the command exportInstance if you click on that it will expand the box and show you the URL you can use to download the export.

NOTE: If you do not have enough disk space to copy your server files the export process will fail and the URL generated will produce a "404" error. We would recommend using the Files sub-menu or sFTP/SSH to remove excess backups or logs that could be 'inflating' the export size.

On rare occasion, the export files may be left on the disk after the task has completed, increasing disk use, these files are located in /home/export/ and the zip is in /home/, to remove these files, either; a) Login using your root sFTP key and delete them, or, b) Send in a ticket and support will nuke them for you!

The .instance file is a ZIP, it can be opened in any ZIP management program such as 7zip, WinRAR, WinZIP etc.
It contains a complete copy of your Minecraft installation, the world, configs, mods.

Importing Instances:

Instances on the new panel can be imported via the "Create Instance" option, this menu will popup a dialog containing the clickable "I'd like to import an instance" option. The "I'd like to import an instance" option will allow you to enter the URL to your instances .instance or CurseForge .zip file.

Legacy panel importing:
Instances can be imported to your control panel later on using the Control Panel > Minecraft > Import Instance menu if you decide to re-implement that installation of Minecraft.

Advanced note: You can also upload the .instance file via sFTP/SSH, rename it to a .zip and 'wget' via sFTP/SSH, or, use the Files sub-menu for your game to 'extract/decompress' your file.