Hardware FixRecommendedDevice not working? Your driver may be the problemCheck updates for common hardware issues.Fix DriversHalloween DealsAmazon USHalloween week deals: useful picks before month-endAmazon US: current deals, useful picks and tech finds.Check DealsPC HealthRecommendedCrashes, freezes, slowdowns? Check your PC nowSpot repairable issues before they interrupt work.Check PC×
Skip to content
World desk11 min

How to Install a Terraria Server With SteamCMD

A complete SteamCMD setup for Terraria: download the server files, create a repeatable config, launch worlds, open port 7777, connect players and troubleshoot network failures.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

SteamCMD downloads and updates the dedicated-server files; TerrariaServer is the program that actually hosts your world. A reliable installation therefore has four parts: a stable SteamCMD install directory, a Terraria server directory, a configuration file, and network rules that expose the port you choose. The documented default is TCP/UDP port 7777 and the default maximum is 16 players, although both can be changed in the configuration.

This guide covers Windows, Linux and macOS hosts, first-time world creation, repeatable starts, firewall and router setup, updates, multiple servers and the failures that most often prevent connections.

As an Amazon Associate I earn from qualifying purchases.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

What SteamCMD does—and what it does not do

SteamCMD is Valve’s command-line downloader and updater for dedicated game servers. It does not run a Terraria world by itself. After SteamCMD has downloaded the server package, you launch the platform-specific executable: TerrariaServer.exe on Windows or TerrariaServer in Linux and macOS shell examples.

Keep these roles separate when troubleshooting:

  • SteamCMD: logs in anonymously where supported, downloads the current server files and applies updates.
  • TerrariaServer: loads a world, listens on a port and accepts player connections.
  • Operating-system firewall: permits or blocks traffic on the host.
  • Router or cloud firewall: determines whether players on the public Internet can reach the host at all.

Terraria server packaging and the Steam app/tool identifier can change. Check Valve’s current SteamCMD supported-games documentation immediately before installation and use the Terraria entry shown there rather than relying on an old app ID copied from a forum post.

#1 Best Overall
Sale
TOZO A1 Wireless Earbuds Bluetooth 5.3 Light Weight in Ear Headphones | IPX5 Waterproof,2 Mics for AI Calls,Immersive Premium Sound Bass Headset with Charging Case,32 EQ via App Black
  • [Ultra-Lightweight Ear Buds Designed for Small Ears] Each earbud weighs only 3.7g and features a compact, ergonomic in-ear design made especially for small ears. Secure, low-profile, and comfortable for workouts, all-day wear or overnight sleeping.The ultra-slim profile sits flush in your ear with no hard edges poking or rubbing, so you can even sleep on your side without discomfort.
  • [Immersive Stereo Sound with TOZO OrigX Technology] TOZO OrigX tuning delivers clear vocals, balanced mids, and natural stereo sound for music, podcasts, and videos.
  • [Long Battery Life for Daily Use] Get up to 7 hours of playtime on a single charge, with up to 32 hours total using the charging case—ideal for workdays, commuting, and extended listening sessions.
  • [Bluetooth 5.3 & Stable Connection] Bluetooth 5.3 provides fast pairing, stable wireless performance, and reduced dropouts as you move around home or office.
  • [Deep Bass with Clear Vocals] High-performance drivers produce punchy bass while keeping vocals clean and detailed for everyday listening.

Choose a host and prepare the directories

Self-hosted computer

Use a machine that can remain powered on whenever players need access. A wired connection is preferable for an Internet-facing server, and the host should have a stable local address so a router forwarding rule does not point at a different device later.

Cloud virtual machine

A cloud VM avoids home-router configuration, but you must open the selected port in the provider’s network firewall as well as in the operating-system firewall. Your cloud provider’s public IP can change unless you reserve an address; record the current address before giving it to players.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Directory layout

Create separate directories so updates, backups and startup scripts do not depend on a temporary download location. For example:

terraria-server/        (the downloaded Terraria files)
terraria-data/          (worlds, configs and backups)
steamcmd/               (SteamCMD itself)

The names are examples; use paths appropriate to your account and operating system. Grant the account that runs the server read/write access to the server and data directories, and avoid placing the world in a directory that is routinely cleaned by the operating system.

Install SteamCMD

Install SteamCMD using Valve’s instructions for your host operating system. Steam Support states that SteamCMD is now used to download and update Steam game-server files. On Linux and macOS, run SteamCMD from a shell; on Windows, run steamcmd.exe from Command Prompt or PowerShell. Let its first run complete any self-update before issuing download commands.

Do not run the server as an administrator or root unless your operating system requires it for a narrowly defined operation. A dedicated, unprivileged account limits the damage a compromised server process could cause.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Download the Terraria server files

Open SteamCMD and use an anonymous login if the current Terraria entry supports it. The exact app/tool identifier must come from Valve’s current supported-games list; no permanent numeric ID is published in that current official entry, so do not substitute an unverified number.

Rank #2
Sale
Smart Watch for Men Women Compatible with iPhone Samsung Android Phone 1.69 inch Full Touch Screen IP68 Waterproof Bluetooh Fitness Tracker Heart Rate/Sleep Monitor (Black)
  • 【IP68 Waterproof Multifunctinal Smart Watch】Torjalph fitness activity tracker smart watch is IP68 waterproof technology ,you can wear it when swimming,handwashing,it's rain-proof which means that you perform multiple exercise modes outside without worrying about sweat or rain corroding your fitness smart watch,and this watch equipped with a 230 mAh large capacity battery magnetic charging ,and this sports activity tracker watch can be used 5-7 days If fully charged.
  • 【Larger 1.83'' Full Screen Watch & Multi-dial Selection】1.83 inch full HD color touch screen smart watch for men / women provides excellent 240*284 resolution image quality ,This Bluetooth smart watch offers a better touch experience and remarkable immersion and ,more than 200 watch faces for you to choose from App"Da Fit ", you can change the dial style according to your mood to wear keeping the world on your wrist
  • 【Accurate Activity Tracker Smart Watch 】sports watch activity tracker uses sweat and dust resistant breathable silicone strap, our Fitness Tracker Smart Watch for Android iOS Phones supports 12 sports modes,walking,running,bicycle,swimming,badminton,basketball,football,rope skipping. This bluetooth calls smart watch for men women is lightweight and stylish, bringing more convenient and relaxing sports experience while also providing more protection.
  • 【Your 24 Hour Personal Daily Health Monitor】Fitness watch for women men full touch screen IP67 waterproof bluetooth smartwatch for Android iOS Phones with heart rate blood pressure monitor multifunction Andriod smart watch with steps counter sleep monitor sports fitness watch, monitoring blood oxygen saturation allows you to understand your physical condition in real time to track fitness progress ,to know your health status in time.
  • 【More Functions Bluetooth Call Smart Watch】This fitness activity smart watch full screen for iPhone and Android phones includes a bunch of new features including:The bluetooth smart watch can hang up the phone, receive and display WhatsAPP /Text /Facebook /Twitter /Messenger reminder.Support sedentary reminder, alarm clock, stopwatch, timer,weather information,music control, remote camera control compatible with Android 5.0 and above or iOS 9.0 and above smartphones.
steamcmd
login anonymous
force_install_dir <terraria-server-directory>
app_update <terraria-server-app-id> validate
quit

In PowerShell or a shell script, the same sequence can be supplied as one command line:

steamcmd +login anonymous +force_install_dir <terraria-server-directory> +app_update <terraria-server-app-id> validate +quit

The angle-bracket values are variables: replace them with the directory and identifier shown in the current documentation. If SteamCMD reports that an app is unknown, unavailable to anonymous users or packaged differently, stop and verify the supported-games entry instead of repeatedly retrying an obsolete command. A successful update leaves the Terraria server executable and its supporting files in the install directory.

Find the executable and test a first launch

Change to the directory created by SteamCMD and start the executable directly. Windows:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
cd /d C:pathtoterraria-server
TerrariaServer.exe

Linux or macOS:

cd /path/to/terraria-server
./TerrariaServer

The first launch presents the server menu. You can select an existing world, create one, choose a port and set a password interactively. This is useful for confirming that the files run before you automate startup. Stop the process with the server’s normal exit command rather than closing the terminal window abruptly.

Create a repeatable configuration file

A configuration file prevents accidental differences between restarts and makes service scripts practical. Create serverconfig.txt in a known directory, then add one setting per line. A minimal example is:

world=/path/to/terraria-data/Worlds/MyWorld.wld
worldpath=/path/to/terraria-data/Worlds
port=7777
maxplayers=16
password=use-a-long-unique-password
motd=Welcome to the server
secure=1

On Windows, use a Windows path such as C:TerrariadataWorldsMyWorld.wld. On Linux, the official default world-save location is ~/.local/share/Terraria/Worlds; on macOS it is ~/Library/Application Support/Terraria/Worlds. A custom worldpath is often easier to back up, but verify the actual path on the host before migrating a world. If the file is saved by a text editor as serverconfig.txt.txt, the server will not find it; enable file-extension display and check the exact name.

Configuration settings

Setting Purpose Important qualification
world= Loads a specific .wld file. Use an absolute path when the server is started by a service or script.
worldpath= Sets the directory used for world files. Ensure the server account can write to it.
port= Sets the listening port. The documented default is 7777; every client must use a changed value.
maxplayers= Sets the player limit. The current official documentation identifies 16 as the default maximum.
password= Requires a password to join. Keep it out of public posts and use a value different from other accounts.
motd= Displays a message of the day. Use plain text that is useful to people joining.
secure=1 Enables additional cheat protection. Leave enabled unless you have a specific reason to change it.
noupnp=1 Disables automatic UPnP port mapping. Useful when you want router forwarding to be managed manually.

Keep the password and any administrative details private. A configuration file is plain text, so protect its file permissions and include it in your backup plan.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
New Bee Guitar Cable 10ft Electric Instrument Bass AMP Cord
  • [Low Noise High Fidelity] New bee guitar cord with 22AWG oxygen-free-copper center conductors provides enhanced signal transfer, the PVC insulation material and the high-density stranded copper double shield provide noise rejection for quiet operation
  • [Ideal for Choice] New bee 1/4 straight and right angle metal connectors, ensures a secure connection in any instrument, pedal, or amp jack. L shape great fro on stage guitar stands
  • [Wide Compatible] Suitable for mixer, power amplifier, microphone, effector, decoder, equalizer, electoronic organ, electric guitar, electric bass and other electronic equipments. Widely used in the installation of smart home, karaoke speaker, professional stage audio, etc
  • [Easy Disassemble] Making incidental repairs quick and easy! Very nice, flexible cable
  • [Dont Hesite to Order] 24 hours customer services and professional technology team are standing by

Create a world when none exists

Use the startup menu

Start TerrariaServer without a configuration file and select the world-creation option. Choose the world size and difficulty through the prompts, then note the resulting .wld path. Add that path to world= for subsequent launches.

Create from command-line switches

You can also create a world non-interactively with the documented switches:

TerrariaServer -autocreate 1 -world /path/to/terraria-data/Worlds/SmallWorld.wld -config serverconfig.txt

-autocreate 1, -autocreate 2 and -autocreate 3 create small, medium and large worlds respectively. Use the Windows executable name on Windows:

TerrariaServer.exe -autocreate 2 -world C:TerrariadataWorldsMediumWorld.wld -config C:Terrariadataserverconfig.txt

After creation, remove the -autocreate switch from normal startup commands so an accidental restart does not attempt to create another world.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Start the server with the configuration

Windows Command Prompt:

cd /d C:pathtoterraria-server
TerrariaServer.exe -config C:pathtoterraria-dataserverconfig.txt

Linux or macOS:

cd /path/to/terraria-server
./TerrariaServer -config /path/to/terraria-data/serverconfig.txt

The -config <file> switch loads the file each time and is repeatable, which makes it suitable for separate scripts or service definitions. The command-line reference also supports these alternatives:

Switch Use
-port <number> Override the listening port for this launch.
-players or -maxplayers Set the player limit from the command line.
-world <path> Load a particular world.
-pass or -password Set the join password.
-motd Set the message shown to joining players.
-secure Enable additional cheat protection.
-noupnp Disable automatic UPnP.
-steam and lobby switches Enable Steam-specific joining behavior when appropriate.

Use one source of truth for each setting. If a value is in the configuration file, avoid overriding it in a startup script unless you deliberately want a per-launch difference.

Open the firewall and network path

Operating-system firewall

Allow the server executable to accept inbound traffic, or create an inbound rule for the selected port. The documented default is 7777; if you choose another port, use that value consistently in the rule, configuration and client connection. Terraria commonly uses both TCP and UDP, so allow both protocols when creating a cloud or host firewall rule.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #4
BSIMB 15.6" Digital Family Calendar & Chore Chart, No Subscription Fees
  • Digital Family Calendar: BSIMB digital calendar wall touch screen puts an end to your chaotic life. Designed for busy families, the digital calendar keeps you organised and in step with your family. Assign different colours and tasks to each family member to make family scheduling easier and more intuitive.
  • Easy Setup and Auto-Sync: Plug in, connect to WLAN and auto-syn your electric calendar in minutes. Digital wall calendar compatible with Google calendar, iCloud calendar, Outlook calendar, Cozi calendar and Yahoo calendar. Add events directly on the device or through the ecalendar app. Electronic calendar stays current whether you're at work or traveling—no manual updates needed.
  • All-In-One Home Assistant: Smart calendar builds habits and encourage independence with personalised chores. Display daily meal plan to reduce the daily ‘What's for dinner?’ stress. To-do lists keep track of everything you want. Turning chores into valuable achievements with stars and rewards, making life easier and more enjoyable.
  • Manage Anytime Anywhere: BSIMB electronic calendar for family stay connected with the powerful ecalendar app. Access and manage your digital wall calendar anytime, anywhere with free features like stars & rewards, photo screensaver, chore charts, meals plans, to-do lists etc. Electronic planner paid features like Magic Import tailor advanced tools for users with special needs.
  • Stay in Touch with Loved Ones: Share photos or videos from your phone to electronic wall calendar with app, instantly update your life moment, and keep in touch with your family, especially those who are far away; you can also surprise your smart calendar digital wall by sending him a wish card; it's also great for keeping tech-illiterate elders in touch with the youngsters.

Home router port forwarding

  1. Give the server computer a stable private address, either with a reserved DHCP lease or a manually configured address.
  2. Open the router’s port-forwarding page.
  3. Forward the chosen external port to the server computer’s private address and the same internal port.
  4. Select TCP and UDP if the router offers protocol choices.
  5. Save the rule and confirm that the host firewall permits the traffic.

Do not test an Internet address from inside the same home network unless the router supports NAT loopback. Test locally first, then ask a player on another network to connect, or use an external port-checking method that you trust.

Cloud firewall

For a cloud VM, create an inbound rule for TCP and UDP 7777, or for the custom port in your configuration, in the provider’s network-security panel. Then add the matching rule to the VM’s operating-system firewall. Opening only one of these layers still leaves the server unreachable.

Connect from Terraria

  1. Launch Terraria on the client.
  2. Choose Multiplayer, then Join via IP.
  3. Enter the server’s local IP address when testing from the same network, or its public IP address for Internet players.
  4. Enter the configured port. Use 7777 only when the server is actually using the default; a changed port must be entered by every client.
  5. Enter the password if one is configured.

For a first test, connect from the host itself or another device on the same LAN. A successful local connection proves that the Terraria process and world are running; it does not prove that router or cloud forwarding is correct.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Run more than one Terraria server

Every simultaneous instance needs its own world, configuration file and port. For example:

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Instance World Config Port
Survival Survival.wld survival.txt 7777
Creative Creative.wld creative.txt 7778

Start each process with its own -config file and open or forward every port that players must reach. Never point two running processes at the same world file; simultaneous writes can corrupt it. Give each instance a distinct log location if your service wrapper supports one.

Back up worlds and update safely

Stop the server cleanly before copying a world. Back up the .wld file, its configuration and any scripts to storage separate from the host. Keep dated copies so you can roll back after a bad update or accidental in-game change.

  1. Announce a maintenance window and stop the Terraria process.
  2. Copy the world and configuration files to a dated backup directory.
  3. Run SteamCMD’s app_update ... validate command using the current supported app/tool entry.
  4. Start the server with the same configuration and watch the console for errors.
  5. Have one player verify the world, port and permissions before reopening the server to everyone.

Do not overwrite backups with an update. SteamCMD updates the server files; it is not a substitute for world backups.

Troubleshooting by symptom

SteamCMD says the app is unknown or unavailable

The identifier or distribution method may have changed. Recheck Valve’s current supported-games documentation, confirm that the command uses the current Terraria server entry and verify that anonymous access is allowed. Do not infer an app ID from a client-game listing.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

TerrariaServer is missing

Confirm that SteamCMD’s force_install_dir points to the directory you inspected and that app_update completed without an error. On Linux or macOS, make sure you are in the correct directory and invoke the file as ./TerrariaServer.

The config file is ignored

Check the exact filename and path, including case on case-sensitive systems. Start with an absolute path after -config. Verify that each setting uses the documented spelling and that the account running the process can read the file.

The server starts but no world loads

Check that world= points to an existing .wld file and that worldpath= is writable. If no world exists, create one through the startup menu or use -autocreate with a valid -world path, then remove -autocreate for later launches.

Players on the same LAN can join, but Internet players cannot

The Terraria process is working; the missing layer is usually forwarding or filtering. Confirm the host’s private address, router rule, operating-system firewall and, for a cloud VM, provider firewall. Check that the player is using the public address and the exact configured port.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Players receive a connection refusal

Confirm that the process is still running and listening on the expected port. A typo in port=, a second process already using the port or a firewall rule for the wrong protocol can all produce this symptom.

A second server will not start

Give it a different port and separate world and configuration files. Two instances cannot listen on the same address and port combination.

The server disappears after closing the terminal

The process is tied to the interactive session. Use an operating-system service or a session manager appropriate to your platform, and point it at the same absolute executable and configuration paths. Test the service under the intended unprivileged account so its world and backup permissions match normal operation.

Self-hosting or managed hosting?

Self-hosting gives you direct operating-system access, complete control of backups and the freedom to install or script around the server. It also makes you responsible for power, uptime, firewall rules, router forwarding and keeping the host updated. Managed Terraria server hosting can be useful when an always-on machine or network administration is impractical, but evaluate the service on the following points before committing:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Decision factor Self-hosted Managed service
Monthly cost Your hardware, electricity and network costs; no current provider price is published for comparison. Recurring provider fee; compare the current plan and renewal terms directly.
Uptime Depends on your power, connection and maintenance. Depends on the provider’s infrastructure and service-level terms.
Port forwarding You configure the router or cloud firewall. Usually handled in a control panel, but confirm the exact process.
Operating-system access Full access to files, scripts and updates. May be restricted to a game panel or selected file manager.
Backups You choose frequency, retention and storage location. Check whether backups are automatic, downloadable and restorable.
Mods and tools You control installed software and compatibility. Confirm supported server versions and mod-management limits.
Player capacity You choose maxplayers, subject to host resources. Plans may impose slots or resource limits.
Geographic latency Usually reflects your home’s or VM’s location. Select a region near the players, if the service offers regions.

Whichever model you choose, retain an independent copy of world files and document the configured port and startup options.

SteamCMD installation checklist

  • SteamCMD runs successfully and is using the current Terraria server entry.
  • The server files are in a permanent directory, not a temporary download folder.
  • TerrariaServer.exe or TerrariaServer launches without a missing-file error.
  • A world exists, or your first-start command creates one.
  • serverconfig.txt contains the intended world path, port, player limit, password and security setting.
  • The host firewall allows the selected port over TCP and UDP.
  • A router forwards the port to the correct private address, or a cloud firewall allows it.
  • Clients know the correct IP address and port.
  • World and configuration backups exist outside the server directory.
  • Additional instances, if any, use separate worlds, configs and ports.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
PC Slower Than It Used to Be?Free scan - under a minute
Crashes, No Sound, or Screen Glitches?Free driver scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.