Terraria

A self-hosted Terraria game server container that downloads and installs the server files, re-checks for updates on each start or restart, and includes a…

  • Game Servers
  • Other
  • Tools & Utilities
A self-hosted Terraria game server container that downloads and installs the server files, re-checks for updates on each start or restart, and includes a browser-based web console for running a private Terraria world with a small group of players on Unraid or other Docker hosts.

Platform availability

Available on 3 of 10 platforms

  • Unraid
  • TrueNAS
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

51/100 Fair

Maintained
86last commit 22 days ago
Popular
102 GitHub stars
Easy to install
553 install platforms, install notes, Docker image
Light to run
208 GB minimum RAM, runs on ARM

Availability: platform listings confirmed today, links checked 6 days ago

GitHub stars
2
Open issues
2
Last commit
2026-10-30
License
MIT
Activity
declining

Checked 19 days ago - source: GitHub (blckassassin/unraid-game-servers)

Resources & Compatibility

Minimum requirements: 8 GB RAM, 50 GB disk. ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Where the mod files go Put manifest.json (the file that describes the mod) and the mod's .dll file (its compiled code) together in a folder under Terraria/TerrariaModder/mods, such as my-first-mod. This is the layout the loader expects, so missing files or a different location can keep the mod from loading. source
  • Keep the mod id simple and matching In manifest.json, set the id using only lowercase letters and hyphens, and make it the same as the mod folder name. If the id doesn't match the folder, the mod may fail to register. source
  • First startup and web console The first start can take a while, since the container downloads the server files and generates the initial map. Once running, manage the server from the built-in web console by opening the host's IP on port 9012 in a browser, or via the WebUI link on the Unraid Docker page. source

Fetched 45 days ago - each note links to its source

Alternatives (2)

  • Project Hedra - Experience endless adventures with Project Hedra, the open-world low-poly exploration game that puts procedurally generated content at the…
  • Veloren - Veloren is a multiplayer voxel RPG written in Rust.

Checked 5 days ago - source: AlternativeTo

Common questions

Can I use the repository’s docker-compose.yml directly on Unraid?

No, that compose file is for local testing only. It uses uid/gid 1000 rather than Unraid’s 99/100 user/group IDs.

Why might a Docker Terraria server stop when a local TerrariaServer.exe is closed?

A user reported that the server only kept running while TerrariaServer.exe was open on their local PC. That suggests the server was dependent on the local process instead of running independently in Docker.

Where is the Terraria server executable if the game is installed through Steam?

Open the game’s local files from the Steam library’s Manage option, then look in the Terraria folder inside the Steam steamapps common directory. Use the TerrariaServer.exe program there to host.

How can multiple players share a Terraria world if they are not all on one server?

The suggested workaround is to send the map file between players after play sessions. If more than two people are involved, rotate who keeps the map open.

Answers sourced from github.com, steamcommunity.com, www.reddit.com, www.reddit.com

Community

Collected 53 days ago - public community threads