ForgeWorld Gaming

Hosting guide

Terraria server not connecting: the fixes

Last checked: 2026-09-29. A Terraria join that never finishes usually has one of five causes: the port is unreachable, the versions do not match, Steam joins are friends-only, the Host & Play session ended, or the world was never saved. This page maps each message to its fix, checked against today's versions.

Updated 29 September 2026

See available Terraria plans

The message, the cause, the fix

Start from what the player actually sees. The wiki's own troubleshooting list for "Others can't connect" — check the address, the firewall, the port, the router (setup guide) — covers most of the first row, and the rows below it are each verified against the source that documents them.

What the player seesThe usual causeThe fix
The connecting screen says the server was found, then the join never finishes. TCP port 7777 is unreachable: the server is not running, a firewall is blocking it, or the address is wrong. Work the wiki's list in order: the right address for where the player is, the firewall allowing TerrariaServer.exe and port 7777, the correct port number if it is not the default 7777, and the router forwarding that port (setup guide).
"You are not using the same version as this server" — the client reports being booted. The client and the server are on different builds: a patched client against an old server, or a vanilla client against a tModLoader server. Put both ends on the same version — today that is the 1.4.5.8 line — and never mix vanilla and tModLoader ends of one server (Re-Logic forums).
A Steam join is refused — the would-be player is not on the host's Steam friend list. "Join via Steam" works "if they are friends on Steam" (Multiplayer), and -lobby friends allows only friends at all (Server). Join by IP with the server's address instead, or become Steam friends first. The address checks below apply either way.
A Host & Play session will not start, or it vanishes partway through the evening. Host & Play runs inside one player's client, and "The world shuts down when the player that hosted the world leaves the world" (Multiplayer). Use a dedicated server for anything that should outlast the host. Our Terraria dedicated server setup guide covers it, and it is also the wiki's own recommendation for saving safely.
The world did not save — items moved between chests are gone after the server closed. The server saves the world at every in-game dawn — about every 24 minutes — "but will only save on shutdown when using the exit command" (Server). Stop with the save and exit console commands, never the window's close button; the setup guide's warning about moving gear between chests and closing right away is exactly this failure (setup guide).

Check the versions first

Version is the first thing to rule out, because the boot message above is exactly what a mismatch produces. Where every platform stands today:

Platform or serverCurrent versionReleased
PC client1.4.5.8August 23, 2026 (PC version history)
Mobile iOS/iPadOS and Google Play1.4.5.8.1 (Build 1720)September 17, 2026 (Mobile version history)
Mobile Amazon Appstore1.4.5.8.6 (Build 1720)September 17, 2026 (Mobile version history)
Console Xbox and PlayStation1.4.5.8.1 (Build 1728)September 17, 2026 (Console version history)
Console Nintendo Switch1.4.5.8.1 (Build 1728)September 22, 2026 (Console version history)
Dedicated server"Terraria Server 1.4.5.8"Current download (Server)
tModLoaderStable is "based on Terraria v1.4.4 content"tModLoader guide for players
TShock"TShock 6.2.1 for Terraria 1.4.5.8"September 27, 2026 (TShock releases)

Three pairing rules sit behind that table. First, the exact boot message — "You are not using the same version as this server" — is quoted from a Re-Logic forums thread where joining players lacked the matching software, and the fix given there was to make the server and every client report the same version (forums). Second, vanilla and tModLoader ends cannot be mixed even on the same game version, as another forums thread puts it plainly: "You cannot mix tModLoader and vanilla client/server" (forums) — and since tModLoader's stable is built on 1.4.4 content, a tModLoader server today is a 1.4.4-series server that current vanilla clients cannot join. Third, a TShock build must match the game version: every release on the TShock releases page is titled for the Terraria version it supports, the current one being "TShock 6.2.1 for Terraria 1.4.5.8", and since version 6 TShock runs on .NET 9 (TShock releases).

One connect bug really was a bug: the current mobile hotfix says "We've fixed up some instances where a network disconnection would cause players to not be able to connect/reconnect" (Mobile version history). A player who cannot reconnect after a dropped line may just need the update. Our Terraria crossplay guide carries what each platform can join.

Check the address

Three addresses get confused, and the wiki's setup guide separates them. On the host computer itself, "You can use localhost as the IP, or use the host IP." Players on the same network type the machine's IPv4 address. Players from the internet "need to enter your external IP (meaning your router's IP)" — and that one "won't work until you set up the aforementioned port forwarding" (setup guide). Giving a friend the machine's LAN address when they are at home is the classic wrong-address failure.

Addresses also drift. The setup guide warns that a dynamic address can change over time and should be re-checked, and that with a dynamic DNS domain the game "only saves the IP address, not the domain name" — so players retype the domain rather than relying on a saved entry (setup guide).

On the server side there is a matching trap: the -ip <ip address> option "Sets the IP address for the server to listen on" (Server). On a machine with several addresses, a server bound to the wrong one is reachable on the network nobody is on. The port side is simpler: the server runs on TCP port 7777 by default, and on a cloud provider the wiki says to "ensure port 7777 on TCP and UDP is open" (Server). Our Terraria setup guide covers the port work, and port forwarding for game servers covers the router side.

When the address is right and nobody can join anyway

Some home connections cannot accept incoming connections at all, and no router setting fixes that. The cause is carrier-grade NAT: the ISP shares one public address between many homes, so the address a player types is not one your router controls. A Re-Logic forums thread titled "Cannot host dedicated server" opens with exactly this dead end — "Cannot host behind CGNAT" — and records that the game's server networking is IPv4-only (forums).

The wiki's alternative for people who cannot forward a port is a virtual network tool: "If one cannot forward a port, one may choose to use a VPN service like Hamachi or Radmin VPN instead", with the caveat that "every player needs to install the VPN software" (Server). The other route is to ask the ISP for a routable address, or to run the server somewhere that already has one.

Read the server log before you change anything

Since the 1.4.5.7 hotfix of August 19, 2026, "Servers now log a message when a player disconnects before having joined the world" (1.4.5.7 changelog). When a player tells you they cannot get in, the log now names who connected and dropped before the world finished loading — read it before touching a setting.

On Linux there is one startup failure worth knowing by name. The setup guide warns "The server will fail to start if $TERM is not set to xterm"; the failure lands in client-crashlog.txt as "System.Exception: Magic number is wrong: 542", and the fix is to run export TERM=xterm and start the server again (setup guide). The Server page carries the same note for its own launch sequence (Server).

Renting a server or hosting it yourself

Every fix above works the same on a server you rent; the difference is who notices when the machine is asleep, the address changed or the log has a complaint in it. The self-hosting path is documented in our Terraria dedicated server setup guide, and it is a genuinely free option when you have a machine that stays on and a connection that accepts inbound joins.

If you would rather have a server that stays online without running it yourself, ForgeWorld Gaming’s Terraria plan is Terraria Standard, 4 player slots, CA$8.99/month; the availability page shows whether orders are currently open. Other sizes and tiers are not available yet. Your server is set up automatically after payment. Current plans and prices are on the Terraria availability page.

Common questions

Why does Terraria say I am not using the same version as this server?

Because the client and the server are on different builds - a patched client against an old server, or a vanilla client against a tModLoader server. Update both ends to the same version, and remember vanilla and tModLoader ends of one server cannot be mixed even on the same game version.

Why does joining stick after the game says it found my Terraria server?

The join cannot reach the server on TCP port 7777. In order: confirm the server is running, confirm the player has the right address (the machine's IPv4 on the same network, the router's external IP from the internet), let the firewall allow TerrariaServer.exe and port 7777, and forward the port on the router.

Can a friend join my Terraria server through Steam?

Join via Steam works for Steam friends - the wiki's wording is that players join "if they are friends on Steam", and the -lobby friends option allows only friends at all. Someone who is not a Steam friend joins by IP instead, using the server's address and port.

Why did my Terraria world not save?

The server saves the world at every in-game dawn, about every 24 minutes, and saves on shutdown only when you use the exit command. Closing the window skips the shutdown save, which is why items moved between chests right before closing can disappear. Stop the server with the save and exit console commands.

What is CGNAT and why does it stop my Terraria server?

Carrier-grade NAT means your ISP shares one public address between many homes, so the address players type is not one your router controls and port forwarding cannot expose your server. Options are a virtual network tool every player installs, asking the ISP for a routable address, or hosting somewhere that already has one.

Do TShock and tModLoader servers use the same version as vanilla?

No. TShock releases are titled for the Terraria version they support - today that is TShock 6.2.1 for Terraria 1.4.5.8, on .NET 9 - while tModLoader's stable is built on Terraria 1.4.4 content, so a tModLoader server is a 1.4.4-series server that current vanilla clients cannot join.

Sources

Check current order availability. Minecraft (Paper, Vanilla and Forge) Standard: 8–56 player slots at CA$9.89–CA$69.23/month; Terraria Standard: 4–24 player slots at CA$8.99–CA$16.99/month; Valheim Standard: 3–10 player slots at CA$11.99–CA$17.99/month; Garry’s Mod Standard: 8–56 player slots at CA$9.89–CA$69.23/month; Factorio Standard: 8–24 player slots at CA$9.99–CA$13.99/month; Palworld Standard: 4–8 player slots at CA$12.99–CA$16.99/month; Enshrouded Standard: 4–6 player slots at CA$11.99–CA$13.99/month; Satisfactory Standard: 4–6 player slots at CA$14.99–CA$18.99/month; Conan Exiles Standard: 8 player slots at CA$15.99/month; 7 Days to Die Standard: 4–8 player slots at CA$10.99–CA$15.99/month; Rust Standard: 50 player slots at CA$19.99/month; Project Zomboid Standard: 8 player slots at CA$13.99/month; ARK Standard: 10 player slots at CA$19.99/month. Other game orders and other sizes and qualities are temporarily paused. Check game availability before ordering. After payment. Your server is set up automatically after payment. Prices are in Canadian dollars, there is no setup fee, and you can cancel any time.

See available Terraria plans

Questions this guide did not answer? Email support@fwg.world for pre-sales help. No account or payment is required.