← Directory

TModLoader

TModLoader is a Docker image for hosting a modded Terraria server, automatically downloading tModLoader mods from the Steam Workshop by ID, scheduling world…

  • Game Servers
  • Other
  • Tools & Utilities
TModLoader is a Docker image for hosting a modded Terraria server, automatically downloading tModLoader mods from the Steam Workshop by ID, scheduling world saves, handling graceful shutdowns, and staying in step with tModLoader releases for self-hosters who want an easy, configurable setup.

Platform availability

Available on 2 of 9 platforms

  • Unraid
  • TrueNAS
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (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.

62/100 Good

Maintained
100last commit 6 days ago
Popular
48258 GitHub stars
Easy to install
452 install platforms, install notes, Docker image
Light to run
106 GB minimum RAM

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

GitHub stars
258
Open issues
31
Last commit
2026-10-09
Activity
rising

Checked 6 days ago - source: GitHub (JACOBSMILE/tmodloader1.4)

Resources & Compatibility

Minimum requirements: 6 GB RAM, 500 MB disk. ARM (e.g. Raspberry Pi) is not supported.

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

First-install notes

  • Start the server with Docker Compose Run docker-compose build to prepare the server files, then docker-compose up to start the TModLoader server. If you skip these, the modded server won’t be ready for players to connect to. source
  • Mod downloads The image supports downloading tModLoader mods from the Steam Workshop using Workshop IDs. source

Fetched today - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Where should persistent Terraria server files be stored when running the Docker image?

Create a data directory on the host machine to house persistent files. This is the intended location for data that should survive container updates or rebuilds.

How does the server get tModLoader mods?

The image can automatically download tModLoader mods from Steam Workshop using Workshop IDs.

How can I keep the server on a specific tModLoader version?

Pull the image using the tModLoader version string as the tag. Previous versions are kept in the Dockerhub registry through the automated workflow.

Do I need to supply a server configuration file?

No, configuration files are optional. They are only needed for precise control over server settings.

Can worlds be saved on a schedule?

Yes, the image supports scheduled world saving.

Answers sourced from github.com

Community

Collected 10 days ago - public community threads