/Vanilla-Terraria

A vanilla Terraria server docker image! For TShock, check out the following: https://github.com/JoshuaTheMiller/Terraria

Primary LanguageDockerfileMIT LicenseMIT

Containerized Vanilla Terraria Server

A vanilla Terraria server image! For TShock, check out the following: | GitHub | Docker |

Discord MediumLink MIT License

Docker Cloud Build Status Docker Cloud Automated build Docker Image Size (tag) Docker Pulls

CodeFactor

A containerized version of Terraria Server running on Linux, courtesy of Mono!

❗ A note on latest

Be very cautious with blindly using latest... Terraria may introduce breaking changes between versions. This can cause your world to be corrupted. It is best to specify an exact tag and only "upgrade" when you are confident that your world will not be ruined when changing to a new version of this image (and thus, a new version of TShock). Creating a backup of your world is advised before any upgrades are performed!

Quickstart

First and foremost, you're going to need Docker. Please check out Docker's documentation for how to install it on the various supported platforms. While the install may be different per platform, the rest of the steps will remain the same (containers sure are nice, aren't they?).

After installing docker, just run the following command and wait a few minutes:

docker run -d -p 7777:7777 --memory=500m --mount source=terraria,target=/world --name="terraria" trfc/vanilla-terraria:1.4.2.3 -autocreate 1 -world /world/Terrarium.wld

Explanation of the command above

Parameter/Option Description
-d run the container in detached mode so you can go about your day.
-p 7777:7777 map port 7777 to the container's port 7777 so that you can connect to the server (since the command does not change the server from its default port).
--memory=500m set the max amount of memory to use so that your system doesn't crash because of out of memory exceptions.
--mount source=terraria,target=/world create (or attach to if existing) a volume so that your world persists even when the container shuts down.
--name="terraria" name the running container "terraria"
trfc/vanilla-terraria:1.4.2.3 use this image 😊 (with a specific tag)
-autocreate 1 -world /world/Terrarium.wld create a small world named Terrarium OR use an existing world named Terrarium (default Terraria server command)

Quickstart with more control

After installing docker, start the container (and your server) in interactive mode:

docker run -it -p 7777:7777 --memory=500m --mount source=terraria,target=/world --name="terraria" trfc/vanilla-terraria:latest

Next, go through the prompts as it asks (make note of the name of your world).

Finally, after the server starts, exit by pressing Ctrl+p followed immediately by Ctrl+q. This will cause the container to switch to daemon mode, which will allow it to keep running in the background.