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

# How to Upload a Custom World in Terraria

> Migrate your adventure to the cloud. Learn the technical workflow for uploading local singleplayer saves or community maps to your Terraria dedicated server.

## Migrating Worlds: Professional Data Transfer

Whether you are transitioning a private singleplayer masterpiece to a coordinated multiplayer group or hosting a renowned community adventure map like *Builder's Workshop*, the Terraria engine facilitates smooth world migration. This procedure involves more than a simple file transfer; you must correctly synchronize the world metadata and pathing within your server configuration to ensure the engine initializes the correct binary data. This guide walk you through the professional technical workflow for world migration on the FREAKHOSTING platform.

<CardGroup cols={2}>
  <Card title="Difficulty" icon="gauge-low">
    Beginner
  </Card>

  <Card title="Time" icon="clock">
    5 Minutes
  </Card>
</CardGroup>

***

## Technical Migration Workflow

Follow these steps to deploy your custom world to your dedicated instance.

<Steps>
  <Step title="Locate Local Binary">
    On your personal workstation, navigate to your local Terraria save repository:
    `Documents \ My Games \ Terraria \ Worlds`
  </Step>

  <Step title="Initialize File Transfer">
    Establish a connection to your server using an [SFTP Client](/portals/game-panel/how-to-connect-via-sftp).
  </Step>

  <Step title="Deploy to World Directory">
    Navigate to the following path: `/Saves/Worlds/`. Upload your **`.wld`** file directly into this folder.
  </Step>

  <Step title="Configure Engine Logic">
    Open the **`serverconfig.txt`** file in your root directory. Update the following parameters to target your new asset:

    * `world=Saves/Worlds/YourWorldName.wld`
    * `worldname=YourWorldName`
  </Step>

  <Step title="Initialize the World">
    **Restart** your server via the Game Panel. Monitor the console to ensure the engine successfully hashes and mounts the uploaded terrain.
  </Step>
</Steps>

***

## Troubleshooting Initialization Failures

If the server generates a generic fresh world instead of loading your custom assets, review these technical commonalities.

<AccordionGroup>
  <Accordion title="Case Sensitivity on Linux">
    Our high-performance nodes use Linux, which is strictly case-sensitive. If your configuration targets `MyWorld.wld` but the physical file is named `myworld.wld`, the engine will fail the lookup and initialize a randomized world to prevent a startup crash.
  </Accordion>

  <Accordion title="Pathing Accuracy">
    Ensure the `world=` string in your config file accurately reflects the technical subdirectory. If the file is placed directly in the root directory rather than `/Saves/Worlds/`, the configuration path must be updated accordingly.
  </Accordion>
</AccordionGroup>

***

<Note>
  ### Need Extra Help?

  If you encounter any issues, our support team is ready to assist:

  * **Live Chat:** Quick assistance via our website.
  * **Support Ticket:** [Open a Ticket](https://freakhosting.com/clientarea/submitticket.php)
  * **Discord:** [Join our Community](https://discord.gg/freakhosting)
  * **Email:** [support@freakhosting.com](mailto:support@freakhosting.com)
</Note>

<Tip>
  ### Save on Your Hosting

  Ready to get a new server? Use code **KB20** at checkout for **20% off** your first month!
</Tip>

***

<div align="center">
  **Last Updated:** January 2026 | **Terraria:** World migration complete.
</div>