# TModLoader

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. It is open source and self-hosted, installable on Unraid and Docker Hub.

Canonical page: https://ourlocalhost.com/app/1225/tmodloader

## Description

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.

## Health score

62/100 (Good), based on 4 of 4 factors.
- Maintained: 100 (last commit 14 days ago)
- Popular: 48 (258 GitHub stars)
- Easy to install: 45 (2 install platforms, install notes, Docker image)
- Light to run: 10 (6 GB minimum RAM)

## Links

- GitHub: https://github.com/JACOBSMILE/tmodloader1.4
- Unraid: https://ca.unraid.net/apps/tmodloader-1szm8oo1d1k510?q=TModLoader
- Docker Hub: https://hub.docker.com/r/jacobsmile/tmodloader1.4

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/1225/tmodloader), the self-hosted and open-source app directory.