← Games

Sandbox · Available in Early Access

Host a Terraria Dedicated Server with Swarm Hosts

Run your own Terraria server and manage worlds, backups, and player access from a browser.

Terraria artwork

Hardware and runtime

What you’ll need

Check my hardware →
CPU
1+ cores
Memory
1 GiB minimum
Player traffic
TCP
Backup coverage
1 saved data location

Allow more capacity for larger worlds, more players, or mods.

Setup and runtime
    Launching the server

    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.

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

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

    text <PLAYERHOSTNAMEORIP>:<ASSIGNEDPORT>

    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.

      Technical overview

      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.

      Read the full Terraria guide →

      Server Actions

      Manage your Terraria server

      Available tools depend on the game, server status, and your permissions. The game guide explains any setup needed for Server Actions.

      Server overview

      Read the pinned server version, port, player limit, and connected-player count.

      List online players

      Refresh the verified online-player list used by player-targeted actions.

      Broadcast message

      Send a server-authored message to connected players.

      Save world now

      Persist the current world and let the pinned runtime complete its save rotation.

      Kick player

      Disconnect one player selected from a fresh verified online-player list.

      Set world time

      Move the world clock to a supported vanilla time boundary.

      Mods & Content status

      Mods and custom content

      This pinned image runs vanilla Terraria. Managed tModLoader and TShock content are intentionally not mixed into this runtime.

      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.

      Know before launch

      Before you launch

      • Host on Windows 10/11 or Linux with Docker Desktop in Linux-container mode on Windows, or Docker Engine or rootful Podman on Linux.
      • Managed shared relay when the game, host, and current relay path support it.

      Windows 10/11 + Linux

      Ready to host Terraria?

      Connect the Windows or Linux computer you already own, then follow the game-specific launch path.