a Docker image for TShock a terraria server

• Use github actions in order to automatically build/test/publish latest TShock release into docker images
• Multi arch: x64 and arm support
• Smart world choosing process

查看中文版

TShock is a toolbox for Terraria servers and communities. That toolbox is jam packed with anti-cheat tools, server-side characters, groups, permissions, item bans, tons of commands, and limitless potential. It's one of a kind.

• Download: official or experimental.
• Download: plugins and tools that work with TShock, TSAPI, and Terraria.
• Read the documentation to quickly get up to speed.
• Join Discord.
• Use the ancient old forums to find old stuff.
• Talk on GitHub discussions to ask for help, chat, and other things. This is the best way to get help if Discord isn't your thing.
• For news, follow @Pryaxis on Twitter.

Built images support multiple architectures such as x86-64, arm64 and armhf.

Pulling tieonlinux/terraria:latest retrieve the image matching your architecture.
You can also pull arch images via specific tags.

The architectures supported are the following:

A standard docker knowledge is required to set this up

docker create \
  --name=terraria \
  -e PUID=1001 \
  -e PGID=1001 \
  -v /path/to/tshock/config:/config \
  -v /path/to/tshock/logs:/logs \
  -v /path/to/tshock/world:/world \
  -v /path/to/tshock/plugins:/plugins \
  --name="terraria" \
  tieonlinux/terraria \
  -world "a world_name.wld"

Note that those parameters are all optional. But it's strongly recommended to use them all.

When using volumes (-v flags) permissions issues can arise between the host OS and the container, we avoid this issue by allowing you to specify the user PUID and group PGID.

Ensure any volume directories on the host are owned by the same user you specify and any permissions issues will vanish like magic.

In this instance PUID=1001 and PGID=1001, to find yours use id user as below:

  $ id username
    uid=1001(terrariauser) gid=1001(terrariagroup) groups=1001(terrariagroup)

• TShock devs
• LinuxServer for inspiration on docker images features / readme

• dumb-init
• gosu
• debian 9
• mono
• python 3
• docker build x