Longvinter Server Docs
Description | Longvinter Server Documentation for Server Administrators |
Author(s) | Uuvana Studios |
Repository | https://github.com/Uuvana-Studios/Longvinter-server-documentation |
Copyright | Copyright © 2021 Uuvana Studios. |
Table of Contents
Linux Guide ↵
Vanilla Setup
If you have any trouble following the guide, please send us a message on Discord or the Uuvana Forums. We are more than happy to help you out!
Requirements and Pre-requisites
- GIT installed in your system;
- GIT LFS installed in your system;
- SteamCMD installed in your system;
- Broadband internet connection;
- Router with the ability to port forward;
- Min. 2 GB RAM;
- Min. 64-bit Linux Operating System.
System Setup
Creating user and group to run the server
sudo useradd -m -d /home/steam steamcmd
Make sure you choose a secure password.
sudo passwd steamcmd
sudo usermod -aG sudo steamcmd
sudo su steamcmd
Installing GIT, GIT Large file system and other requisits
.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:
Ubuntu/Debian
sudo apt update
sudo apt install git git-lfs steamcmd
Note: If you are using a 64 bit machine you will need to add multiverse.
sudo add-apt-repository multiverse
sudo dpkg --add-architecture i386
sudo apt update
sudo apt install lib32gcc-s1 steamcmd
Arch-Linux
sudo pacman -Sy
sudo pacman -S git git-lfs
git clone https://aur.archlinux.org/steamcmd.git
cd steamcmd
makepkg -si
sudo ln -s /usr/games/steamcmd /home/steam/steamcmd
Fedora
sudo yum update
sudo yum install git git-lfs steamcmd
Installing Steam SDK
The Steam server browser needs SteamSDK. For this, we need to install SteamCMD which needs to be done under the SteamCMD user:
Make sure we are in the steamcmd user home directory:
cd ~/
Create the SteamCMD directory:
mkdir steamcmd-source
Go into the newly created SteamCMD directory:
cd steamcmd-source
Now download the compressed SteamCMD installer:
wget https://steamcdn-a.akamaihd.net/client/installer/steamcmd_linux.tar.gz
After that, extract it:
tar -xvzf steamcmd_linux.tar.gz
Finally run SteamCMD to login, install a app update and quit upon completion with the following command:
./steamcmd.sh +force_install_dir . +login anonymous +app_update 1007 +quit
Steam CMD will install updates automatically and login to install 64-bit SDK.
Copying Steam SDK to the right place
We still need to move the SDK to default location where the server can interact with it:
Go to the steam folder:
cd ~/.steam
Create folder for the 64-bits SDK:
mkdir sdk64
Copy the required steamclient.so
file from SteamCMD:
cp ~/steamcmd-source/linux64/steamclient.so ~/.steam/sdk64/
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:
Warning
In other tutorials it is asked to open the TCP Port 7777, do not do it. Unreal Engine doesn't use TCP connections - you would be leaving a unused port open by doing so!
IPTables
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
Uncomplicated Firewall (UFW)
sudo ufw allow 7777/udp
sudo ufw allow 27016
sudo ufw allow 27015
Installing the server
In this step let's first return to the steamcmd user home directory:
cd ~/
Then we will clone the linux repository:
git clone https://github.com/Uuvana-Studios/longvinter-linux-server.git
Then we want to give permission for this folder to execute commands with:
sudo chmod -R ugo+rwx longvinter-linux-server/
Customizing the server
Server values can be customized with Game.ini
Create the file for edit with:
nano ~/longvinter-linux-server/Longvinter/Saved/Config/LinuxServer/Game.ini
Add the following content there:
[/Game/Blueprints/Server/GI_AdvancedSessions.GI_AdvancedSessions_C]
ServerName=Unnamed Island
ServerTag=Default
MaxPlayers=32
ServerMOTD=Welcome to Longvinter Island!
Password=
CommunityWebsite=www.longvinter.com
[/Game/Blueprints/Server/GM_Longvinter.GM_Longvinter_C]
AdminSteamID=76561198965966997
PVP=true
TentDecay=true
MaxTents=2
ChestRespawnTime=600
What does each setting mean?
Setting name | Used for | Default value |
---|---|---|
ServerName | It's the name that shows up in the server browser. Please don't call your server with OFFICIAL name. We want players to clearly know if they are joining a server that is hosted by other players. | Unnamed Island |
<<<<<<< HEAD | ||
ServerTag | It's the tag that allows for easier search of the server. Please don't use your the word OFFICIAL on it. We want players to clearly know if they are joining a server that is hosted by other players. And only place one tag. | Default |
ServerMOTD | Server message that is on a signs around the island. | 32 |
MaxPlayer | Maximum allowed players that can connect at any given time. | Welcome to Longvinter Island! |
======= | ||
ServerMOTD | Server message that is on a signs around the island. | Welcome to Longvinter Island! |
MaxPlayer | Maximum allowed players that can connect at any given time. | 32 |
>>>>>>> e6189a2069adb03c5916b1a5f6935e1d6a3af8e1 | ||
CommunityWebsite | Allows you to promote a website on a same place where the server message is shown. This link can be opened in-game. | www.longvinter.com |
Password | Add you password here. Use only number and letters. If left empty there is no password on the server. | (empty) |
ChestRespawnTime | How much is the maximum respawn time for loot chests. | 600 |
AdminEosID | Here you can add all the admins that you want to have in the server. Your EOS ID can be found in the general settings tab. If you want to add multiple separate the ID's with single space. | 76561198965966997 |
PVP | Here you write true or false if you want to enable/disable Player versus Player fights. |
|
TentDecay | Here you write true or false if you want to enable/disable tent decay to make sure there isn't an abundant number of abandoned tents in the server. |
|
MaxTents | Maximum allowed of tents that players that can place in the server |
Running the server
Start the server manually with shell script
sh /home/steam/longvinter-linux-server/LongvinterServer.sh
Start the server automatically with Systemd (Recommended)
sudo cp /home/steam/longvinter-linux-server/longvinter.service /etc/systemd/system/longvinter.service
sudo cp /home/steam/longvinter-linux-server/longvinter.socket /etc/systemd/system/longvinter.socket
sudo systemctl daemon-reload
How to use Systemd Management
-
How to start the server:
sudo systemctl start longvinter.service
-
How to stop the server:
sudo systemctl stop longvinter.service
-
How to restart the server:
sudo systemctl restart longvinter.service
-
How to enable the server to start on boot:
sudo systemctl enable longvinter.service
-
How to check status the server:
sudo systemctl status longvinter.service
-
How to see real-time logs of the server:
sudo journalctl -u longvinter -f
-
How to see all the logs of the server:
sudo journalctl -u longvinter
- How to get the ID of the server(Requires server initialization first):
./LongvinterGetId.sh
If the console shows these lines at the bottom during or after startup, your server has started up correctly.
[2022.02.22-12.51.34:514][ 13]LogOnline: Verbose: STEAM: FOnlineAsyncEventSteamServerConnectedGS ServerId: Server[0x***************]
[2022.02.22-12.51.34:782][ 21]LogOnline: Verbose: STEAM: FOnlineAsyncEventSteamServerPolicyResponseGS Secure: 1
[2022.02.22-12.51.34:849][ 23]LogOnline: Verbose: OSS: Async task 'FOnlineAsyncTaskSteamCreateServer bWasSuccessful: 1' succeeded in 2.828243 seconds
[2022.02.22-12.51.34:849][ 23]LogOnlineSession: Warning: STEAM: Server setting ,TOTPLAYING_s:0 overflows Steam SetGameTags call
[2022.02.22-12.51.34:849][ 23]LogOnlineSession: Warning: STEAM: Server setting ,ServerName_s:[EU] Uuvana 1 overflows Steam SetGameTags call
Server Maintenance
Updating the server
We have created an automated script that you can run to automatically update and restart a server.
bash /home/steam/longvinter-linux-server/LongvinterUpdate.sh
Backing up your saves
We have created an automated script that you can run to automatically backup and restart a server, for now it has to be run manually and it requires user input.
bash /home/steam/longvinter-linux-server/LongvinterBackup.sh
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!
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.
System Setup
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:
Ubuntu/Debian
sudo apt update
sudo apt install git git-lfs
Arch-Linux
sudo pacman -Sy
sudo pacman -S git git-lfs
Fedora
sudo yum update
sudo yum install git git-lfs
Installing Docker
Ubuntu/Debian
Begin by adding dependencies needed by the installation process:
sudo apt-get install apt-transport-https ca-certificates curl gnupg lsb-release
Begin by adding dependencies needed by the installation process:
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
Begin by adding dependencies needed by the installation process:
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
Now you can install Docker:
sudo apt-get install docker-ce docker-ce-cli containerd.io
Start and enable docker service:
sudo systemctl start docker && sudo systemctl enable docker
Add your user account to the docker group:
sudo usermod -aG docker $USER
newgrp docker
Fedora
Add Docker’s package repository:
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
Install Docker:
sudo dnf install docker-ce docker-ce-cli containerd.io
Start and enable docker service:
sudo systemctl start docker && sudo systemctl enable docker
Add your user account to the docker group:
sudo usermod -aG docker $USER
newgrp docker
Arch Linux
Install Docker using an AUR-Helper:
sudo paru -S --noconfirm --needed docker
Add your user account to the docker group:
sudo usermod -aG docker $USER
newgrp docker
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:
Warning
In other tutorials it is asked to open the TCP Port 7777, do not do it. Unreal Engine doesn't use TCP connections - you would be leaving a unused port open by doing so!
IPTables
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
Uncomplicated Firewall (UFW)
sudo ufw allow 7777/udp
sudo ufw allow 27016
sudo ufw allow 27015
Setting up the container
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
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/
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:
Setting name | Used for | Default value |
---|---|---|
CFG_SERVER_NAME | Setting the server name that is displayed in the server list. | Unnamed Island |
CFG_MAX_PLAYERS | The maximum amount of players the server will allow at the same time. | 32 |
CFG_SERVER_MOTD | A Message Of The Day that will be displayed to the player. | Welcome to Longvinter Island! |
CFG_PASSWORD | Use this setting to require a password to join the server. | (empty) |
CFG_COMMUNITY_WEBSITE | When the server or community has a website, enter it here to display it to the player. | www.longvinter.com |
CFG_ADMIN_STEAM_ID | Add the SteamID64 values for the players that have admin rights to this setting. When there are multiple admins, add the SteamID64 values to this setting separated by a space. | (empty) |
CFG_ENABLE_PVP | When this setting is set to "true", PvP will be enabled on the server. Set to "false" to disable PvP. | true |
CFG_GAME_PORT | This setting is used to change the game port when multiple servers are running on the same (public) IP address. When changing this setting, make sure to also change the port number under the ports section of the docker-compose.yaml file. | 7777 |
CFG_QUERY_PORT | This setting is used to change the query port when multiple servers are running on the same (public) IP address. When changing this setting, make sure to also change the port number under the ports section of the docker-compose.yaml file. | 27016 |
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"
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"
Note
Even though changing the ports is possible, it is currently not supported by the game!
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:
- Build the container image (if not present)
- Create the container
- Start the container
- Run the included startup script (
run.sh
) inside the container - Clone or update the longvinter-linux-server repository
- Create or update the Game.ini file with the settings provided in the
docker-compose.yaml
file - Start the Longvinter server
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
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
Dockerfile
, docker-compose.yaml
and run.sh
files.
Updating the Longvinter server
Updating the Longvinter server is as easy as restarting the container:
docker-compose restart
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
new-name-here
. Make sure to change the server ports using the Changing the port numbers step.
Note
This works in theory but, remember, that even though changing the ports is possible, it is currently not supported by the game!
Ended: Linux Guide
Windows Guide ↵
Vanilla 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!
Requirements and Pre-requisites
- GIT installed in your system;
- GIT LFS instaled in your system;
- Steam installed in your system;
- Broadband internet connection;
- Router with the ability to port forward;
- Min. 3 GB RAM;
- Min. 64-bit Windows 10 Operating System.
Installing the server
The easiest way to install the server is to right-click and git bash to the folder where you want to install the server files. You can also use CMD if you installed just GIT and not the GIT BASH.
Enter the following command to clone the GitHub repository to your wanted folder: NOTE: cloning creates a new folder for the files so no need to make a folder for the repository beforehand.
git clone https://github.com/Uuvana-Studios/longvinter-windows-server.git
Once the cloning is done you should see the following files inside the folder command created.
You now have installed the server!
Customizing the server
You can customize some server parameters by editing the Game.ini config file
Go to server folder and navigate to Longvinter ->Saved -> Config -> WindowsServer
Here you should create a new file and name it Game.ini
Open it for edit. You can use any text editor you want. Add the following content inside this file.
[/game/blueprints/server/gi_advancedsessions.gi_advancedsessions_c]
ServerName=Unnamed Island
ServerTag=Default
MaxPlayers=32
ServerMOTD=Welcome to Longvinter Island!
Password=
CommunityWebsite=www.longvinter.com
[/game/blueprints/server/gm_longvinter.gm_longvinter_c]
AdminEosID=97615967659669198
PVP=true
TentDecay=true
MaxTents=2
ChestRespawnTime=600
What does each setting mean?
Setting name | Used for | Default value |
---|---|---|
ServerName | It's the name that shows up in the server browser. Please don't call your server with OFFICIAL name. We want players to clearly know if they are joining a server that is hosted by other players. | Unnamed Island |
ServerTag | It's the tag that allows for easier search of the server. Please don't use your the word OFFICIAL on it. We want players to clearly know if they are joining a server that is hosted by other players. And only place one tag. | Default |
ServerMOTD | Server message that is on a signs around the island. | 32 |
MaxPlayer | Maximum allowed players that can connect at any given time. | Welcome to Longvinter Island! |
CommunityWebsite | Allows you to promote a website on a same place where the server message is shown. This link can be opened in-game. | www.longvinter.com |
Password | Add you password here. Use only number and letters. If left empty there is no password on the server. | (empty) |
AdminEosID | Here you can add all the admins that you want to have in the server. Your EOS ID can be found in the general settings tab. If you want to add multiple separate the ID's with single space. | 76561198965966997 |
PVP | Here you write true or false if you want to enable/disable Player versus Player fights. |
|
TentDecay | Here you write true or false if you want to enable/disable tent decay to make sure there isn't an abundant number of abandoned tents in the server. |
|
MaxTents | Maximum allowed of tents that players that can place in the server | |
ChestRespawnTime | How much is the maximum respawn time for loot chests | 600 |
Running the server
// To Do
Open Ports
You also need to open ports on your home router to allow traffic go through. This process is greatly different from what type of router you have. It is recommended to look in the manual provided by the manufacturer or contact your ISP for instructions.
P.S.A.
You currently cannot connect to server hosted from same machine (localhost).
Warning
In other tutorials it is asked to open the TCP Port 7777, do not do it. Unreal Engine doesn't use TCP connections - you would be leaving a unused port open by doing so!
- For Steam open: 27015 & 27016 (TCP and UDP)
- For Unreal Engine open: 7777 (UDP Only)
In some cases, opening the ports in your home router is not enough. In that case you usually also need to allow the ports in your software firewall. Windows has a built-in firewall, but some antivirus packages also include a firewall feature. For changing the settings on your antivirus firewall, look for instructions online or contact the developer directly.
Setting ports rules on Windows Firewall
In order to open the ports in the included Windows Firewall, follow the steps below:
- Open the Start Menu and search for "Windows Defender Firewall with Advanced Security", or the equivalent in your language.
-
Right-click the Inbound Rules option on the left side and choose New Rule...
-
In the window that opens, select the Port option and click Next.
-
Next, enter the port that you wish to forward, select the correct protocol (TCP or UDP) and click Next.
-
Make sure "Allow the connection" is selected and click Next.
-
Make sure all options are selected and click Next.
-
Give the firewall rule a recognizable name (Such as Longvinter [port]) and click Finish.
Make sure to repeat steps 2-7 for each port that needs to be openend in the firewall.
Updating To Latest build
I suggest you update the server every time you start it. The best rule of thumb is that if your game has updated in steam. This means you also have to update the server.
Updating is done by opening the server folder in GIT BASH or in CMD as I showed earlier. The difference is that you now have to be inside the folder and not where it is located.
First, verify that you are in the folder by typing:
git status
If console prints:
fatal: not a git repository (or any of the parent directories): .git
This means you are in the wrong folder and you cannot pull the update from here.
Updating is simple. Just execute these two lines separately
git restore .
git pull
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!
Requirements and prerequisites
- 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 Windows 10 Operating System.
System Setup
Post-Installing Docker
After installation, restart your computer if necessary. Then open the Docker Dashboard by right-clicking the docker icon on the bottom right of your screen, or open Docker using your start menu. Depending on your OS and/or updates you may be asked to install "WSL 2". Make sure you do this as well.
Setting up the container
Choosing a location on your computer/server
It is recommended to place the server in your documents or on your desktop for ease of access.
Open Windows Explorer where you would like to place the server and right click somewhere. Click the option "Git Bash Here".
This will open a command line in the location you right-clicked. From here, execute the commands in the next chapters.
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/Uuvana-Studios/longvinter-docker-server.git
When the clone is finished, enter the directory the git command created:
cd longvinter-docker-server
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
Configuring the server settings
The server settings can be changed by opening the docker-compose.yaml
file. Use either Notepad or a more advanced text editor such as Notepad++. Do not open the configuration using WordPad or Word! Settings that may be changed are shown below:
Setting name | Used for | Default value |
---|---|---|
CFG_SERVER_NAME | Setting the server name that is displayed in the server list. | Unnamed Island |
CFG_MAX_PLAYERS | The maximum amount of players the server will allow at the same time. | 32 |
CFG_SERVER_MOTD | A Message Of The Day that will be displayed to the player. | Welcome to Longvinter Island! |
CFG_PASSWORD | Use this setting to require a password to join the server. | (empty) |
CFG_COMMUNITY_WEBSITE | When the server or community has a website, enter it here to display it to the player. | www.longvinter.com |
CFG_ADMIN_STEAM_ID | Add the SteamID64 values for the players that have admin rights to this setting. When there are multiple admins, add the SteamID64 values to this setting separated by a space. | (empty) |
CFG_ENABLE_PVP | When this setting is set to "true", PvP will be enabled on the server. Set to "false" to disable PvP. | true |
CFG_GAME_PORT | This setting is used to change the game port when multiple servers are running on the same (public) IP address. When changing this setting, make sure to also change the port number under the ports section of the docker-compose.yaml file. | 7777 |
CFG_QUERY_PORT | This setting is used to change the query port when multiple servers are running on the same (public) IP address. When changing this setting, make sure to also change the port number under the ports section of the docker-compose.yaml file. | 27016 |
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"
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"
Note
Even though changing the ports is possible, it is currently not supported by the game!
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:
- Build the container image (if not present)
- Create the container
- Start the container
- Run the included startup script (
run.sh
) inside the container- Clone or update the longvinter-linux-server repository
- Create or update the Game.ini file with the settings provided in the
docker-compose.yaml
file
- Start the Longvinter server
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
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
Note
Remember that these commands have to be run from the same directory as the Dockerfile
, docker-compose.yaml
and run.sh
files.
Updating the Longvinter server
Updating the Longvinter server is as easy as restarting the container:
docker-compose restart
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/Uuvana-Studios/longvinter-docker-server.git new-name-here
new-name-here
. Make sure to change the server ports using the Changing the port numbers step.
Note
This works in theory but, remember, that even though changing the ports is possible, it is currently not supported by the game!
Open Ports
You also need to open ports on your home router to allow traffic go through. This process is greatly different from what type of router you have. It is recommended to look in the manual provided by the manufacturer or contact your ISP for instructions.
Warning
In other tutorials it is asked to open the TCP Port 7777, do not do it. Unreal Engine doesn't use TCP connections - you would be leaving a unused port open by doing so!
- For Steam open: 27015 & 27016 (TCP and UDP)
- For Unreal Engine open: 7777 (UDP Only)
In some cases, opening the ports in your home router is not enough. In that case you usually also need to allow the ports in your software firewall. Windows has a built-in firewall, but some antivirus packages also include a firewall feature. For changing the settings on your antivirus firewall, look for instructions online or contact the developer directly.
Setting ports rules on Windows Firewall
In order to open the ports in the included Windows Firewall, follow the steps below:
- Open the Start Menu and search for "Windows Defender Firewall with Advanced Security", or the equivalent in your language.
-
Right-click the Inbound Rules option on the left side and choose New Rule...
-
In the window that opens, select the Port option and click Next.
-
Next, enter the port that you wish to forward, select the correct protocol (TCP or UDP) and click Next.
-
Make sure "Allow the connection" is selected and click Next.
-
Make sure all options are selected and click Next.
-
Give the firewall rule a recognizable name (Such as Longvinter [port]) and click Finish.
Make sure to repeat steps 2-7 for each port that needs to be openend in the firewall.