Terraria-Docker

This is a docker image created to be able to run a vanilla Terraria server on Raspberry Pi 4 based on the Alpine linux image and using Mono.

Creating a world

This image is designed to be used with a serverconfig file configured to look in the appropriate directory for worlds and autogenerate if not found. To use with an existing world, place that .wld file in the folder mapped to /worlds and update the serverconfig accordingly. An example serverconfig is included but the most important lines are as follows

#All paths are relative to run.sh (/root)
#Load a world and automatically start the server
world=worlds/YOUR_WORLD_HERE.wld

#Creates a new world if none is found. World size is specified by: 1(small), 2(medium), and 3(large).
autocreate=2

#Sets the difficulty of the world when using autocreate 0(classic), 1(expert), 2(master), 3(journey)
difficulty=0

#Sets the name of the world when using autocreate
worldname=worlds/YOUR_AUTOCREATED_WORLD_HERE.wld

#Sets the folder where world files will be stored
worldpath=/worlds

Creating image

To create your docker image, download Dockerfile and run-server.sh from this repository and build from your local directory with docker build . -t NAME_YOUR_IMAGE. Or you can point directly to this repository with docker build https://github.com/nanderson97651/Terraria-Docker.git -t NAME_YOUR_IMAGE.

Starting contianer

The container can be started using docker run. Be sure to expose host port 7777 and map the /worlds and /config folders to your desired location on the host. /config should hold a valid serverconfig file and all worlds will be saved in /worlds.

docker run -it -p 7777:7777 \
-v ~/YOUR_TERRARIA_DIRECTORY/worlds:/worlds \
-v ~/YOUR_TERRARIA_DIRECTORY/config:/config \
--name Terraria_Server \
YOUR_DOCKER_IMAGE

32-bit Errors

Alpine 3.13 introduced changes that impacted compatibility of Alpine with 32 bit systems, including the RPi4. This is corrected with an updated version of libseccomp2 that has not been pulled into Raspberry Pi OS yet (as of Kernal 5.10). In order to correct this error, update to a more recent version of libseccomp2 using the following commands.

wget http://ftp.debian.org/debian/pool/main/libs/libseccomp/libseccomp2_2.5.1-1_armhf.deb
sudo dpkg -i libseccomp2_2.5.1-1_armhf.deb

TODO

Add graceful shutdown

Credit

This is heavily inspired by the work of ryshe, jonifen, and beardedio.