2. Docker Setup

If you have any trouble following the guide. Please send us a message in Discord we are more than happy to help you out!

2.1 Requirements and Pre-requisites

• GIT installed in your system;
• GIT LFS installed in your system;
• Docker and Docker-Compose installed in your system;
• Broadband internet connection;
• Router with the ability to port forward;
• Min. 2 GB RAM;
• Min. 64-bit Linux Operating System.

2.2 System Setup

2.2.1 Installing GIT and GIT Large file system

.pak files are large and we need to install Git Lfs in order to download them

Run the following commands according to your chosen system:

sudo apt update

sudo apt install git git-lfs

sudo pacman -Sy

sudo pacman -S git git-lfs

sudo yum update

sudo yum install git git-lfs

2.2.2 Installing Docker

sudo apt-get install apt-transport-https ca-certificates curl gnupg lsb-release

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

echo "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt-get install docker-ce docker-ce-cli containerd.io

sudo systemctl start docker && sudo systemctl enable docker

sudo usermod -aG docker $USER

newgrp docker

sudo dnf -y install yum-utils device-mapper-persistent-data lvm2 dnf-plugins-core

sudo dnf config-manager --add-repo https://download.docker.com/linux/fedora/docker-ce.repo

sudo dnf install docker-ce docker-ce-cli containerd.io

sudo systemctl start docker && sudo systemctl enable docker

sudo usermod -aG docker $USER

newgrp docker

sudo paru -S --noconfirm --needed docker

sudo usermod -aG docker $USER

newgrp docker

2.3 Port-forwarding and Firewalls

If you are running this in your home network it will be necessary to do port forwarding or open ports in your firewall. For port forwarding instructions, please refer to the information/documentation provided by your ISP or router/modem manufacturer.

For opening ports in your linux machine use the following depending on the firewall software you are using:

sudo iptables -I INPUT -p udp --dport 7777 -j ACCEPT

sudo iptables -I INPUT -p udp --dport 27016 -j ACCEPT

sudo iptables -I INPUT -p tcp --dport 27016 -j ACCEPT

sudo iptables -I INPUT -p udp --dport 27015 -j ACCEPT

sudo iptables -I INPUT -p tcp --dport 27015 -j ACCEPT

sudo ufw allow 7777/udp

sudo ufw allow 27016

sudo ufw allow 27015

2.4 Setting up the container

2.4.1 Downloading the container

Downloading the container can be done by either using git (recommended), or by clicking the green Code button on this page and using the Download ZIP option on the Docker Image Github. To download the container configuration using git, use the command below

git clone https://github.com/tvandoorn/longvinter-docker-server.git

2.4.2 Creating the data directory

In order to keep game progress between container restarts a data directory needs to be created. Create this directory in the same directory as the docker-compose.yaml file. Use the following commands to create the directory and set the appropriate rights.

mkdir data

chown -R 1200:1200 data/

2.4.3 Configuring the server settings

The server settings can be changed by opening the docker-compose.yaml file. Settings that may be changed are shown below:

With the default values above, the environment part of the docker-compose.yaml file should look like this:

  environment:
    CFG_SERVER_NAME: "Unnamed Island"
    CFG_MAX_PLAYERS: "32"
    CFG_SERVER_MOTD: "Welcome to Longvinter Island!"
    CFG_PASSWORD: ""
    CFG_COMMUNITY_WEBSITE: "www.longvinter.com"
    CFG_ADMIN_STEAM_ID: ""
    CFG_ENABLE_PVP: "true"
    CFG_GAME_PORT: "7777"
    CFG_QUERY_PORT: "27016"

2.4.4 Changing the port numbers

In order to run the server with different port numbers than the default ports 7777 and 27016, the new port numbers have to be edited in two places in the docker-compose.yaml file.

  ports:
    - "7777:7777"
    - "27016:27016"

  environment:
    CFG_GAME_PORT: "7777"
    CFG_QUERY_PORT: "27016"

2.5 Starting the container

When the setup and configuration is done, the container is ready to be started. Open the command line and navigate to the directory (using the cd command) that contains the Dockerfile, docker-compose.yaml and run.sh files.

Start the container using the following command:

docker-compose up -d

This command will do the following:

1. Build the container image (if not present)
2. Create the container
3. Start the container
4. Run the included startup script (run.sh) inside the container
5. Clone or update the longvinter-linux-server repository
6. Create or update the Game.ini file with the settings provided in the docker-compose.yaml file
7. Start the Longvinter server

2.6 Stopping the container

To stop the container, run the command below. Note that this removes the container from Docker, but the save data will be saved in the data directory and will be loaded when the server is started again next time.

docker-compose down

2.7 Updating the container

When a new version of the container is released, make sure to update the files using git pull, or manually update the files by downloading the code as ZIP from Github. Run the command below to build the new container image and restart the container.

docker-compose up -d --build

2.8 Updating the Longvinter server

Updating the Longvinter server is as easy as restarting the container:

docker-compose restart

2.9 Running multiple Longvinter containers on one Docker server

Running multiple Longvinter containers on one Docker server is very easy. Follow the Setting up the container steps again, but this time set up the server to use a different directory for the new server.

git clone https://github.com/tvandoorn/longvinter-docker-server.git new-name-here