How to Upload an Existing Terraria World to Your Server
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.
- Local worlds:
Documents\My Games\Terraria\Worldson Windows,~/.local/share/Terraria/Worldson Linux,~/Library/Application Support/Terraria/Worldson macOS. - Upload the
.wldfile. For tModLoader worlds, also upload the matching.twldfile. - 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
Step 1: find your world files
| Platform | Folder |
|---|---|
| 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
- 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.
- Open the Worlds tab.
- Upload the
.wld. For a tModLoader world, upload the matching.twldfile as well. - 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.
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.
autocreateand 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=andworldname=. They only apply to newly created worlds, so your world keeps the mode it was made in. - Case matters on Linux.
MyWorld.wldandmyworld.wldare 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
.wldwill not load, try the.wld.baknext to it. The TEdit documentation notes.bakfiles 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.