Guide:Setting up a Terraria server

From Terraria Wiki
Jump to: navigation, search

Setting up your server[edit]

The first thing you need to do is to discover your IP address, in order to do that click on the start button, then click on your search bar (or run button if you are using Windows XP) and type 'cmd', press enter. It will bring up a little command window. Type 'ipconfig' and press enter. You will see a whole bunch of words and numbers but don't worry and just scroll back to the top. Under the top one which is usually 'Ethernet Adapter Local Area Connection' or 'Wireless LAN adapter Wireless Network Connection 2' if you have a wireless connection, find 'IPv4 Address' which is your computers IP address. Now there are two possibilities. If you are using a router your IP address will be 10.x.x.x, 172.16(-31).x.x or 192.168.x.x, in which case you need to follow the steps below. If your IP address is something else you can continue to Setting up the server. Write down the IP address you found. Also take note of your Default Gateway (which we aren't going to tell you what that is); You need this number to forward the port and this is what you have to do next. Go ahead and write these two numbers down and close the window. Now open up a browser window and type your Gateway number. It might be / .0.2 / .1.1 / etc. It depends on how your network is configured. You should see your router configuration login screen. Now, for most modern routers, Username is 'admin' and the password is 'admin' as well. It also might be 'password'. You can try these combinations but if it's a few years old you may have to do some digging around.

Making a server in details[edit]

Difference between LAN IP and Internet IP[edit]

If you are not sure about your IP address, there are a few ways to find out.

To play over Internet:[edit]

One of the most simple ways is to browse a website made for checking your IP, for example WIMI (What Is My Ip).
Alternately, you can type IP as a search query in Google. The first result will be your IP address.
You can also search "cmd" in the start menu.

To play on LAN:[edit]

Your LAN IP is easy to recognise, there are three type of LAN IPs: 10.x.x.x, 172.16(-31).x.x, 192.168.x.x., where "x" is a number from 1 to 254. For example, if your IP address is don't worry, it's a invalid LAN IP address, although usually it tends to be something like

The other players will need to know this IP address to join your server!

You can add your server to a Terraria Server List to get more players:
- Terraria Online
- Terraria Server List
- TServerWeb - Terraria Server List and Server Manager
- Terraria Connect
(If they are unable to join your server, check the Troubleshooting section below.)

Setting up the server[edit]

Setting up a "Host&Play" server[edit]

This is the most simple way of creating a server. You start Terraria and in the main menu you choose "Multiplayer", then "Host&Play", select a world to play in (or create a new one, then select), enter a password (if you leave it empty, there will be no password for your server) and there you go.

Difference between dedicated and non-dedicated servers[edit]

There are two kind of servers: dedicated, non-dedicated. The difference is that a dedicated server should run on a separated computer, which is "dedicated" to run the game as a server. Non-dedicated servers are those which use the "Host&Play" mode of the game. There are problems with this method, for one: if you disconnect the server will stop, meaning all connected players will disconnect as well. A dedicated server will run as a separate process. Regardless of whether you are connected or not, it will continue running until you stop it. It is recommended (if you have a computer to run as the server) to make it a dedicated server so it won't matter who is in the game or not (not to mention: for a proper internet server this is a basic requirement). There is another important feature of the dedicated server: it is "not fully" running the game, meaning it doesn't need any kind of graphical interface, because it only runs as a server, so it doesn't need that much of resources nor graphical drivers (no need for XNA), and it doesn't need a strong or new computer to work as a dedicated server.

Setting up dedicated server without configuration file[edit]

First try setting up a server WITHOUT a configuration file. To do this search for the folder where Terraria is installed and find the "TerrariaServer.exe" then run it. A new black window has opened. This is the server control interface, you will do everything from here and it awaits us now to choose a world. If you have a "clean installation" (you just installed Terraria and did not play with it) it will have no world(s). Otherwise the first options would be the list of worlds you have and then the two command options to create a new world or to delete an existing one.

Guide setting up a server 01.png

Creating world in server console[edit]

1, Type "n", then ENTER.
To do so, you simply type "n" for the option "New World" then hit the ENTER.
2, Select world size, ENTER.
Next you need to select the size of the world, for example choose "1" for "Small" and ENTER again (always finish command with ENTER).
3, Name the world, ENTER.
Now you have to name the world. This name will show up when someone joins the game (for example, you choose the name "Brave New World" and when someone joins the game later he/she will see "Welcome to Brave New World!").
4, It will now generate the new world then return to the world selection screen.
It is also possible to run the game first with "Terraria.exe", go to "Single Player", create a new world there, then exit and select it in the server console.
NOTE: Terraria saves all worlds as default into "C:\Users\UserName\Documents\MyGames\Terraria\Worlds". World file's names are not the same as the name of the world. Example: "world1.wld" can be named "Brave New World" but there are no signs of this in the file's appearance.

Select world in server console[edit]

1, Type corresponding number, ENTER.
Now you select the world you want to play on, type the corresponding number of the world and ENTER.
2, Set number of maximum players.
Decide on the number of maximum players allowed on the server (default is 8, if you simply hit ENTER without typing anything, then it will be 8).
3, Set port.
Set server port number (default 7777, this could be very important for servers over the internet, but also for LAN servers, check Troubleshooting for more information).
4, Set password.
Set the password of your server. This will be asked from anyone who tries to join your server. If you leave it empty and just hit ENTER, there will be no password for the server.
Now your server is running! Test it by starting your Terraria and connect to it (if you play on the same computer where the server is running, go to Multiplayer->Join->Select your character->Type in "localhost" or "", if you are on a different computer type in the IP address of the server). It should be fine, but if not, then check the Troubleshooting section.
NOTE: Terraria saves all worlds as default into "C:\Users\UserName\Documents\MyGames\Terraria\Worlds". World file's names are not the same as the name of the world. Example: "world1.wld" can be named "Brave New World" but there are no signs of this in the file's appearance.

Setting up dedicated server with configuration file[edit]

To run a server with a pre-made configuration file you must search for your Terraria installation folder, then run "TerrariaServer.exe -config <serverconfigfile>", where <serverconfigfile> is the configuration file.
How to do this:
1, Use cmd or TC (TotalCommander), go to Terraria folder and type in "TerrariaServer.exe -config <serverconfigfile>" without the quotation marks, then ENTER.
2, Make a shortcut of "TerrariaServer.exe", right-click on it, click on "Properties", edit the field "Target:" (originally: "<...>\TerrariaServer.exe"), type at the end, after "TerrariaServer.exe" the following: " -config <serverconfigfile>" without the quotation marks (important, leave a SPACE between the ".exe" and the "-config"). It should look like this: "<...>\TerrariaServer.exe -config <serverconfigurationfile>" Then apply it. From now on this shortcut will start your server with the given configuration file.
3, If you want to, you can make a batch file as well, in it's function it is the same as a shortcut. First, you make a new text file (.txt), then edit it in anykind of simple editor (not Office, something like Notepad), then type in the commands like this:
@echo off
TerrariaServer.exe -config <serverconfigurationfile>
Then save the text file (.txt) as a batch file (.bat), or save it as a text, then rename it and change its extension from ".txt" to ".bat". But in this example you will have to place the batch file in the Terraria folder to make it work and the configuration file must be in the same folder as well. Otherwise, if you type in the full path for the "TerrariaServer.exe" and the <serverconfigurationfile> it will work anywhere and act as a shortcut. Example for full path:
"C:\Games\Terraria\TerrariaServer.exe -config D:\TerrariaCon\example.txt"
As you can see in this example, the configuration file doesn't need to be in the Terraria folder.
It is possible to run more than one server from one computer! But to do so there are three important things:
1, Make sure each server uses different configuration file!
2, Make sure each server uses different worlds!
3, Make sure each server uses different port numbers!
NOTE: Recommended to make each server a separated shortcut/batch file.

Making a configuration file[edit]

There is an example configuration file in the Terraria folder, it looks like this if you open it in a text editor (not Office, something like Notepad):
#this is an example config file for TerrariaServer.exe
#use the command 'TerrariaServer.exe -config serverconfig.txt' to use this configuration or run start-server.bat
#please report crashes by emailing crashlog.txt to [email protected]

#the following is a list of available command line parameters:

#-config <config file>				Specifies the configuration file to use.
#-port <port number>				Specifies the port to listen on.
#-players <number> / -maxplayers <number>	Sets the max number of players
#-pass <password> / -password <password>	Sets the server password
#-world <world file>				Load a world and automatically start the server.
#-autocreate <#>				Creates a world if none is found in the path specified by -world. World size is specified by: 1(small), 2(medium), and 3(large).
#-banlist <path>				Specifies the location of the banlist. Defaults to "banlist.txt" in the working directory.
#-worldname <world name>			Sets the name of the world when using -autocreate.
#-secure					Adds addition cheat protection to the server.

#Set’s the max number of players allowed on a server.  Value must be between 1 and 255

#Load a world and automatically start the server.
#world=C:\Users\Defaults\My Documents\My Games\Terraria\Worlds\world1.wld

#Set the port number

#Set the server password

#Set the message of the day
#motd=Please don’t cut the purple trees!

#Sets the folder where world files will be stored
#worldpath=C:\Users\Defaults\My Documents\My Games\Terraria\Worlds\

#Creates a new world if none is found. World size is specified by: 1(small), 2(medium), and 3(large).

#Sets the name of the world when using autocreate

#The location of the banlist. Defaults to "banlist.txt" in the working directory.

#Adds addition cheat protection.

#Default system priority 0:Realtime, 1:High, 2:AboveNormal, 3:Normal, 4:BelowNormal, 5:Idle
You can see that every line starts with a "#" sign. That sign "comments-out" everything in that line if it starts with "#". Meaning that those lines have no effect at all on the server. This is useful for both commenting in the file, like:
#Set the message of the day
As it explains the following command. And it is also useful for turning off commands, like:
#motd=Please don’t cut the purple trees!
Here, the server won't have "MessageOfTheDay", because it is "commented-out". So, if you want to use a command you just need to delete the "#" from the begining of the line. You can edit this file to your liking as much as you want. Every command is explained in the file. If you are ready, you just have to save the file and use it as a configuration file.
It is highly recommended to leave the original configuration file, make a copy of it and edit the copy, or open the original and "Save As..." another file, with a different name.


There could be many reasons if something is not right. You can separate it into three groups.

"The server is not starting!"[edit]

This is mostly because of some typo or miss-typing. Check everything again (especially true for those who use configuration file(s)), is everything typed correctly? If it's still no good try reinstalling the game.

"Others can't connect to the server!"[edit]

This is usually a network related problem.
1st, make sure they try to connect to the right IP address (especially true over the internet).
2nd, make sure your firewall is not blocking the "TerrariaServer.exe" or the server's port ("7777" by default).
3rd, make sure the others join with the correct port number (especially true, if it's not the default "7777").
(Over internet)4th, if you are using a router you have to make sure it opens the server's port for you. In your router you need to do this by setting up the "Port Forwarding" or "Virtual Server", usually you need to make a new record there, it will ask a port number, this is your servers port (default "7777"), it will ask for an IP address as well, this is your LAN IP address (not the Internet IP address). Also, make sure that that the list in "Port Forwarding"/"Virtual Server" is the list of "allowed" connections, if it's not then don't make any record (if you made one, you can delete it and it means that this should not be your problem).
(Over internet)5th, if your IP address is dynamic (not static or reserved) it is possible for it to change over time, so check your IP address again. Also, if you are using Dynamic DNS to get around this problem, tell the other players to always type in your Domain Name to join and don't use the saved list of connections which the game offers (the game only saves the IP address, not the domain name, so if your IP has changed it won't be aware of it).

"World not saved/Items disappear from chests after closing server!!"[edit]

The Terraria server only saves the world automatically at regular time intervals.

If you close the server without issuing a save/exit command via the console (or if you use host and play), there's a chance that the world may not have saved the last few minutes of changes. So moving gear between chests and immediately closing the server without explicitly specifying the save/exit command May actually cause those items to disappear.

To ensure this isn't an issue: Always use a dedicated server, and remember to enter the "save"/"exit" commands rather than simply closing the console window via the red close button.

Basics Walkthrough • Getting started • What Not to Do • Crafting 101 • Inventory cleaning • Class setups • Mining techniques • Monster farming • Replenishable resources • Making liquid • Making money
Pre-Hardmode Bosses Mobile only.pngLepus • King Slime • Eye of Cthulhu(Servant of Cthulhu) • Eater of Worlds • Brain of Cthulhu(Creeper) • Queen Bee(Bee) • Skeletron • Wall of Flesh‎(Leech)
Hardmode Getting Started with Hardmode • Containing the Hallow/Corruption • Harvesting Souls • Harvesting Key Molds • Crafting a Terra Blade
Hardmode Bosses The Twins • The Destroyer • Skeletron Prime • Plantera • Golem • Console only.pngOcram • Duke Fishron
Other Dungeon Guardian • Events
Building Bases • Base defense • Remote NPCs • Arena • Gardening • Wiring • Travel • Artificial biomes
Surviving Corruption • Crimson • Ocean • Jungle • Dungeon • Underworld • Lihzahrd
Multiplayer Setting up a Terraria server • Capture the Gem • PvP