> ## Documentation Index
> Fetch the complete documentation index at: https://docs.purpify.host/llms.txt
> Use this file to discover all available pages before exploring further.

# Migrate a Minecraft server to Purpify

> Move a complete Java or Bedrock server from another host with Purpify's Importer and the old provider's SFTP details.

Use Purpify's **Importer** with the SFTP connection details from your old hosting provider. Match the source server's edition, Minecraft version, and server software before starting the imported files.

## Record the source configuration

Before moving files, record:

* Minecraft Java Edition or Minecraft Bedrock Edition
* Exact Minecraft version and server software
* Java mod loader and loader version, when used
* Installed plugins, mods, datapacks, or Bedrock add-ons
* Active world name and every related dimension folder
* Any special startup or installation requirements for the server software

## Prepare the Purpify server

1. Create the destination server and select the matching edition, software, and Minecraft version.
2. Keep the Purpify server stopped while the import runs.
3. Find the SFTP details for the server at your old provider. You need the old SFTP host, port, username, and password.

## Import the server

<Steps>
  <Step title="Stop the source server">
    Warn players, perform a normal stop, and leave the source offline. Files copied while the source is running may contain an inconsistent world or player state.
  </Step>

  <Step title="Open Importer">
    Open the destination server in the Purpify game panel and select **Importer**.
  </Step>

  <Step title="Enter the old provider's SFTP details">
    Enter the SFTP host, port, username, and password supplied by your old hosting provider. Use the old server's credentials, not the SFTP details shown by Purpify.
  </Step>

  <Step title="Start the import">
    Confirm the source details and start **Importer**. Keep both services available and do not start either Minecraft server while files are transferring.
  </Step>

  <Step title="Wait for completion">
    Wait until the panel reports that the import finished. Do not edit or replace destination files during the transfer.
  </Step>

  <Step title="Start and read the console">
    Start the Purpify server and watch the complete startup for missing files, incompatible software, or version errors.
  </Step>
</Steps>

<Warning>
  SFTP credentials give access to the old server's files. Enter them only in Purpify's **Importer**, never in a public message or screenshot. Change the old password after migration if you keep the old service.
</Warning>

## Verify the migration

* Join with the new server address and port.
* Check player inventories, permissions, spawn, and every dimension.
* Test plugins, mods, add-ons, commands, and scheduled tasks.
* Update DNS only after the destination works through its direct address.
* Keep the source service offline but available until the final checks pass.

<Columns cols={2}>
  <Card title="Upload a Java world" icon="earth-americas" href="/java/upload-world">
    Check Java world folders and `level-name`.
  </Card>

  <Card title="Upload a Bedrock world" icon="cubes" href="/server/upload-world">
    Check `level.dat`, the `db` directory, and world selection.
  </Card>
</Columns>