dbendit/terraria repository overview

⁠Usage

docker create -it \
  --name=terraria \
  -v <path to data>:/config \
  -e world=<world_file_name> \
  -p 7777:7777 \
  dbendit/terraria

⁠Supported tags and respective Dockerfile links

• vanilla-1.3.5.3, vanilla-latest (vanilla/1.3.5.3/Dockerfile)⁠
• vanilla-1.3.4.4 (vanilla/1.3.4.4/Dockerfile)⁠
• vanilla-1.3.3.3 (vanilla/1.3.3.3/Dockerfile)⁠
• vanilla-1.3.2.1 (vanilla/1.3.2.1/Dockerfile)⁠
• vanilla-1.3.1.1 (vanilla/1.3.1.1/Dockerfile)⁠
• tshock-4.3.26, tshock-latest, latest (tshock/4.3.26/Dockerfile)⁠
• tshock-4.3.25 (tshock/4.3.25/Dockerfile)⁠
• tshock-4.3.24 (tshock/4.3.24/Dockerfile)⁠
• tshock-4.3.23 (tshock/4.3.23/Dockerfile)⁠
• tshock-4.3.22 (tshock/4.3.22/Dockerfile)⁠
• tshock-4.3.20 (tshock/4.3.20/Dockerfile)⁠
• tshock-4.3.19 (tshock/4.3.19/Dockerfile)⁠
• tshock-4.3.18 (tshock/4.3.18/Dockerfile)⁠
• tshock-4.3.17 (tshock/4.3.17/Dockerfile)⁠
• tshock-4.3.16 (tshock/4.3.16/Dockerfile)⁠
• tshock-dev-2366, tshock-dev-latest (tshock-dev/2366/Dockerfile)⁠
• tshock-dev-2361 (tshock-dev/2361/Dockerfile)⁠
• tshock-dev-2344 (tshock-dev/2344/Dockerfile)⁠
• tshock-dev-2339 (tshock-dev/2339/Dockerfile)⁠
• tshock-dev-2336 (tshock-dev/2336/Dockerfile)⁠
• tshock-dev-2329 (tshock-dev/2329/Dockerfile)⁠
• tshock-dev-2301 (tshock-dev/2301/Dockerfile)⁠
• tshock-dev-2298 (tshock-dev/2298/Dockerfile)⁠
• tshock-dev-2295 (tshock-dev/2295/Dockerfile)⁠
• tshock-dev-2290 (tshock-dev/2290/Dockerfile)⁠

⁠Quick reference

• Where to get help: the TShock Forums⁠ or the Terraria Forum⁠

• Where to file issues: https://github.com/dbendit/terraria/issues⁠

• Maintained by: Brandon Skrtich of Bearded.io⁠

• Supported Docker versions: the latest release⁠ (down to 1.8 on a best-effort basis)

⁠What is Terraria Server?

A Terraria server provides a platform for players to connect over the internet or other network for multiplayer games of Terraria⁠.

⁠How to use

⁠Generating a new world

To run with out user intervention Terraria Server needs to be configure to use an already generated world. This means you can use one that you have already generated or you can generate one via docker by running this command:

sudo docker run -it -p 7777:7777 \
    -v $HOME/terraria/config:/config \
    --name=terraria \
    dbendit/terraria

You can then follow the prompts to create a new world.

⁠Starting your server with a preexisting world

The world file needs to exist in the config folder. To start a server using an already generated world, use this command:

sudo docker run -dit \
  --name=terraria \
  -v $HOME/terraria/config:/config \
  -e world=<world_file_name> \
  -p 7777:7777 \
  dbendit/terraria

If you get an error from docker saying the container name already exists, it means you need to remove your old docker container process. sudo docker rm terraria

If you want to reattach to any running containers: sudo docker attach terraria Now you can execute any commands to the terraria server. Ctrl-p Ctrl-q will detatch you from the process.

⁠dbendit/terraria:tshock-

TShock is a server modification for Terraria, written in C#, and based upon the Terraria Server API. It uses JSON for configuration management, and offers several features not present in the Terraria Server normally.

⁠dbendit/terraria:tshock-dev-

TShock dev are unreleased development builds of TShock. These builds may be unstable but they are updated faster then the released versions so they support new versions of Terraria faster.

⁠dbendit/terraria:vanilla-

Vanilla Terraria server is the server software provided by the developers of Terraria. This version has only basic features but it is updated along with the main game so it should always be up to date.

If a docker image isn't available of the latest versions please contact us⁠ about the new release so we can update this repo.

⁠FAQ

• Can I manage my own plugins for tshock? Yes, if you want manage you own plugins for tshock containers, you can add a volume mount to your docker command via -v <path to plugins folder>:/tshock/ServerPlugins. If you want to maintain any of the plugins that ship with tshock, you will need to copy them into the ServerPlugins folder. Mounting the plugins folder will override the plugins that ship with tshock.

⁠Notes

• Please check the TShock instructions⁠ for properly installing and configuring your terraria server.
• Any additional command-line instructions⁠ can be added to the end of either method for launching a server. Docker maps the $HOME/terraria/world linux-host folder to the /tshock/world container-folder.
• More information about running a server is available in the wiki⁠.

⁠License

The MIT License (MIT) Copyright (c) 2019 Brandon Skrtich