Swarm Hosts / Guides

Terraria

Terraria runs over TCP and persists its config and world files under /opt/terraria/config. Swarm Hosts waits for the TCP listener to open before promoting the Swarm Server to Running.

The managed image runs the vanilla Terraria dedicated server with persistent world and configuration storage.

Basics you should know

  • Default protocol: TCP
  • Typical port: 7777/tcp
  • Persistent data: /opt/terraria/config
  • Worlds: /opt/terraria/config/Worlds
  • Runtime: vanilla Terraria; the running version appears in Server overview
  • Minimum resources: 1 CPU and 1 GB RAM
  • Recommended default: 2 CPUs and 2 GB RAM, especially while creating a new world

Launch

  1. Open Launch and choose Terraria.
  2. Select a Swarm Host or Swarm Zone and set the resource limits.
  3. Leave Auto-create world enabled for a new server.
  4. Set World name, Max players, an optional Server password, and Message of the day.
  5. Leave Cheat protection enabled unless you have a specific reason to disable it.
  6. Choose Launch Terraria and confirm the launch review.

If you already uploaded a world file into /opt/terraria/config/Worlds, disable Auto-create world and set World name to the uploaded world's name. After launch, use Settings → Terraria Settings to change managed values. Saving settings restarts or recreates the server and disconnects players.

Common paths

  • World files: /opt/terraria/config/Worlds
  • Server config: /opt/terraria/config/serverconfig.txt
  • Logs: /opt/terraria/config/Logs

Swarm Hosts backs up /opt/terraria/config, including the generated server configuration, world files, and vanilla ban list.

Server Actions

Use Server Tools → Actions to check the server, manage online players, send a message, save the world, or change the time of day. Each action has a dedicated form and a result you can review. There is no raw console or shell input.

Available actions are:

  • Server overview: reports the pinned server version, listening port, player limit, and connected-player count.
  • List online players: refreshes the short-lived verified player selector.
  • Broadcast message: sends a bounded server-authored message.
  • Save world now: waits for the game's save response and checks the updated world file before reporting success.
  • Kick player: uses a freshly listed online player, rechecks that they are still online, and verifies their disconnection. Requires administrator access and confirmation.
  • Set world time: accepts only dawn, noon, dusk, or midnight, then reads the world clock back.

Server Actions require the Swarm Server to be running. Player selectors expire after 30 seconds; run List online players again if a target is stale.

Ban-list changes, live password or MOTD changes, and arbitrary console commands are unavailable in Server Actions. Use the normal Stop control when you want to stop the server.

The normal Stop control is separate from Server Actions. With a current agent, it first saves and verifies the world. If that save cannot be verified, Terraria stays running and Swarm Hosts reports the failure. After a verified save, Swarm Hosts stops the server and reports whether it shut down cleanly. Older agents use a generic stop without this save verification; update the agent before relying on it.

Mods & Content

This image is vanilla Terraria and has no Mods & Content page. Swarm Hosts does not install tModLoader or TShock into this image. Manage vanilla world files through Files & Backups.

Connect

Players join with the player hostname or IP and assigned TCP port shown on the Swarm Server page:

<PLAYER_HOSTNAME_OR_IP>:<ASSIGNED_PORT>

After restoring a backup or replacing a world file, restart the Swarm Server and confirm Server overview and List online players both succeed before inviting players.