terraria

Docker images to run a Terraria Server. Latest 1.4.3.2 images with Vanilla Server are available.

Usage

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

Docker Images are avaiable on Docker Hub

Supported tags and respective `Dockerfile` links

vanilla-1.4.3 (containers/vanilla/1.4.3/Dockerfile)
vanilla-1.4.3.2, vanilla-latest, latest (containers/vanilla/1.4.3.2/Dockerfile)
vanilla-1.4.3.1 (containers/vanilla/1.4.3.1/Dockerfile)
vanilla-1.4.2 (containers/vanilla/1.4.2/Dockerfile)
vanilla-1.4.2.3 (containers/vanilla/1.4.2.3/Dockerfile)
vanilla-1.4.2.2 (containers/vanilla/1.4.2.2/Dockerfile)
vanilla-1.4.2.1 (containers/vanilla/1.4.2.1/Dockerfile)
vanilla-1.4.1 (containers/vanilla/1.4.1/Dockerfile)
vanilla-1.4.1.2 (containers/vanilla/1.4.1.2/Dockerfile)
vanilla-1.4.1.1 (containers/vanilla/1.4.1.1/Dockerfile)
vanilla-1.4.1.0 (containers/vanilla/1.4.1.0/Dockerfile)
vanilla-1.4.0.5 (containers/vanilla/1.4.0.5/Dockerfile)
vanilla-1.4.0.4 (containers/vanilla/1.4.0.4/Dockerfile)
vanilla-1.4.0.3 (containers/vanilla/1.4.0.3/Dockerfile)
vanilla-1.4.0.2 (containers/vanilla/1.4.0.2/Dockerfile)
vanilla-1.4.0.1 (containers/vanilla/1.4.0.1/Dockerfile)

Quick reference

Where to get help: the Terraria Forum
Where to file issues: https://github.com/dereckhall/terraria/issues
Thanks to: Brandon Skrtich of Bearded.io

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 \
    dereckh/terraria:vanilla-latest

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 \
  dereckh/terraria:vanilla-latest

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.

dereckh/terraria:vanilla-latest

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.

FAQ

I started the container but it keeps asking me to select a world, help?! You need to ether start the server with an existing world, in which case the server will start automaticly. Or you need to run the continer interactivly using the -it flag. This will allow you to create a new world.

Notes

More information about running a server is available in the wiki.

License

The MIT License (MIT)

dereckhall/terraria