We are your new 5-Star Hosting Company. At least according to ★ Trustpilot

Following along with a Terraria server? Deploy yours in minutes.

All servers come with a 24-Hour Trial, Free Backups, and 40Gbps DDoS Protection included!

Use code SAVE15 to take 15% OFF Your First Invoice with ChicagoServers! Limited Time!
Terraria guide

How to Upload an Existing Terraria World to Your Server

By the ChicagoServers team · Updated · 5 min read

On Windows your Terraria worlds are in Documents\My Games\Terraria\Worlds. Upload the .wld file (and its .wld.bak backup if you want it) on your server's Worlds tab, then switch the server to that world. In the game's own terms that is the world= setting in serverconfig.txt, which makes the server start directly into the file.

The two things that go wrong are a file path that does not match and a version mismatch between where the world was last saved and the server's Terraria version. Both are covered below. Checked against the Terraria Wiki (Desktop 1.4.5) on 2026-11-01.

Quick answer
  • Local worlds: Documents\My Games\Terraria\Worlds on Windows, ~/.local/share/Terraria/Worlds on Linux, ~/Library/Application Support/Terraria/Worlds on macOS.
  • Upload the .wld file. For tModLoader worlds, also upload the matching .twld file.
  • Upload the file on the Worlds tab and switch to it, then Restart. You do not edit world= yourself, and the new-world fields (difficulty, autocreate) do not change an existing world.
  • A world saved by a newer Terraria version generally will not open on an older server. Match versions and keep a backup.
On this page
  1. Step 1: find your world files
  2. Step 2: upload the file to the server
  3. Step 3: tell the server to load it
  4. Step 4: start the server and confirm the right world loaded
  5. Version compatibility
  6. Worlds from the Steam Workshop and other sources
  7. Backups and recovering a damaged world
  8. Frequently asked questions

Step 1: find your world files

PlatformFolder
Windows%UserProfile%\Documents\My Games\Terraria\Worlds
Linux~/.local/share/Terraria/Worlds
macOS~/Library/Application Support/Terraria/Worlds
Windows, tModLoader%UserProfile%\Documents\My Games\Terraria\tModLoader\Worlds

A world appears as a .wld file named after the world, usually with a .wld.bak next to it. The .bak is the previous save and is what you reach for if the main file is damaged. Characters are separate .plr files in the neighboring Players folder and do not need to be uploaded.

Steam Cloud. If cloud saves are enabled, a copy also exists under Steam's userdata folder, in userdata\YOUR_STEAM_ID\105600\remote (the worlds subfolder holds the world files). If the two copies differ, use the one with the newer modified time. Close Terraria before copying so you do not catch a world mid-save.

Step 2: upload the file to the server

  1. Open your server in the panel. If you are replacing the world the server is currently running, make a backup first (Backups tab, World and settings, Back up now) and click Stop.
  2. Open the Worlds tab.
  3. Upload the .wld. For a tModLoader world, upload the matching .twld file as well.
  4. Do not open or edit the file. If you rename it, remember the new name for the next step; a simple name with letters, numbers and underscores avoids path headaches.

The Terraria server hosting page lists what is included, such as free server backups and SFTP file access.

Step 3: tell the server to load it

On the Worlds tab, switch to the uploaded world, then click Restart at the top of the page so the server loads it. You do not set world= or edit serverconfig.txt for this.

Reference: what the setting looks like in serverconfig.txt
world=/home/terraria/.local/share/Terraria/Worlds/MyWorld.wld
# leave autocreate commented out so a typo never generates a new world
#autocreate=2
  • Do not rely on the new-world settings. autocreate and the New world size / difficulty / seed fields on the Startup tab only apply to newly created worlds. If a path or name typo makes the server generate a fresh world, you get an empty world instead of an error.
  • Ignore difficulty=, seed= and worldname=. They only apply to newly created worlds, so your world keeps the mode it was made in.
  • Case matters on Linux. MyWorld.wld and myworld.wld are different files.

Step 4: start the server and confirm the right world loaded

Click Start or Restart and watch the Console tab for errors. Join, and check a chest or base you know exists. If you see a fresh world with the right name but none of your builds, the server created a new file rather than loading yours; recheck which world is selected on the Worlds tab and look for an extra world in the list.

Stopping the server with Stop at the top of the page saves the world; in the Console tab, exit saves too and exit-nosave does not, so avoid it on a server with progress you want to keep.

Version compatibility

The server and every client must run the same Terraria version. Terraria's developers warned when 1.4 changed the world and player file formats that files loaded into the newer version could no longer be used in older ones unless you kept backups, and the same caution applies to any version update. In practice:

  • A world made on an older version will usually load on a newer server, but once it has been saved there you generally cannot go back.
  • A world saved by a newer game version generally will not open on an older server. If a server hangs on loading right after you uploaded a world, check the versions first (Terraria version on the Startup tab, and Terraria server version on the Updates tab).
  • This guide was checked against Desktop 1.4.5.x; the wiki lists 1.4.5.8 (August 2026) as the latest. Check the Terraria Wiki or Steam page for any newer patch.

Worlds from the Steam Workshop and other sources

Terraria 1.4 added Steam Workshop worlds. When you import one, the game writes new .wld and .wld.bak files into your Worlds folder, and their names do not match the Workshop title. Sort the folder by date modified to find the two new files, then upload the .wld like any other world. Worlds shared as downloads from other players work the same way: they are just .wld files, so drop them in the folder, check they load in your own game first, and then upload.

It is worth loading any world you did not make in singleplayer once before putting it on a server. That confirms the file is intact and shows its difficulty, which then applies on the server too. If it turns out to be a Journey world, remember that only Journey characters can join it.

Backups and recovering a damaged world

  • Take a backup of the world before replacing any world on the server: Backups tab, World and settings, Back up now. Star the backup to keep it from being replaced.
  • If the main .wld will not load, try the .wld.bak next to it. The TEdit documentation notes .bak files are usually the best recovery option.
  • If neither loads, the world editor TEdit can sometimes open a damaged file and recover most of the build, but anything cut off mid-save, such as chest contents, may be empty.
  • Journey worlds (see the difficulty guide) can only be played with Journey characters, so check this before you tell friends the world is ready.

Frequently asked questions

Where are Terraria world files stored?

On Windows in Documents\My Games\Terraria\Worlds, on Linux in ~/.local/share/Terraria/Worlds, and on macOS in ~/Library/Application Support/Terraria/Worlds. They are .wld files, with a .wld.bak backup beside them.

How do I make my Terraria server use an uploaded world?

Upload the .wld on the Worlds tab, switch to it and restart the server. In serverconfig.txt terms that is world= pointing at the file; the server then starts straight into that world.

Why did my server create a new world instead of using mine?

The server created a new world because the selected world or file name did not match your upload (in serverconfig.txt, a wrong world= path with autocreate enabled). Check the spelling, case and which world is selected on the Worlds tab.

Can I upload a world from a newer Terraria version to an older server?

Generally no. Worlds saved by a newer version usually will not open in older ones. Update the server to the same version as your game instead, and keep a backup of the world first.

We are your new 5-Star Hosting Company. At least according to ★ Trustpilot

Following along with a Terraria server? Deploy yours in minutes.

All servers come with a 24-Hour Trial, Free Backups, and 40Gbps DDoS Protection included!

We offer quality support, a detailed knowledgebase, video tutorials on most topics, and even live support in case you prefer a live human.

Use code SAVE15 to take 15% OFF Your First Invoice with ChicagoServers! Limited Time!