English | 한국어

This is a Docker container to help you get started with hosting your own Longvinter dedicated server.

Applying source code Uuvana-Studios/longvinter-docker-server to source code thijsvanloef/palworld-server-docker to generate this image.

This Docker container has been tested and will work on the following OS:

• Windows 11
• Ubuntu 22.04

This container has also been tested and will work on both x64 and ARM64 based CPU architecture.

• Longvinter
  • X(Twitter)
  • Reddit
  • TicTok
  • Instagram
  • Server Docs
  • Discord
• Uuvana
  • X(Twitter)
  • Youtube
  • Instagram
  • Media Kit
  • Forum
  • FAQ(Frequently Asked Questions)

• OS: Min. 64-bit
• RAM: Min. 2GB

from: https://docs-server.longvinter.com

Keep in mind that you'll need to change the environment variables.

After running the server, you can check the server log with the command docker log longvinter-server. To check in real time, add -f at the end.

This repository includes an example docker-compose.yml file you can use to set up your server. Write the file first and then execute the command docker compose up -d from that directory.

services:
  longvinter-server:
    container_name: longvinter-server
    image: kimzuni/longvinter-docker-server:latest
    restart: unless-stopped
    stop_grace_period: 30s # Set to however long you are willing to wait for the container to gracefully stop
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"
    ports:
      - "7777:7777/tcp"
      - "7777:7777/udp"
      - "27016:27016/tcp"
      - "27016:27016/udp"
    environment:
      TZ: "UTC"
      PUID: 1000
      PGID: 1000
      PORT: 7777 # Optional but recommended
      QUERY_PORT: 27016 # Optional but recommended
      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_COOP_PLAY: false
      CFG_COOP_SPAWN: 0
      CFG_SERVER_TAG: "none"
      CFG_ADMIN_STEAM_ID: ""
      CFG_ENABLE_PVP: true
      CFG_TENT_DECAY: true
      CFG_MAX_TENTS: 2
    volumes:
      - ./data:/data

As an alternative, you can copy the .env.example file to a new file called .env file. Modify it to your needs, check out the environment variables section to check the correct values. Modify your docker-compose.yml to this:

services:
  longvinter-server:
    container_name: longvinter-server
    image: kimzuni/longvinter-docker-server:latest
    restart: unless-stopped
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"
    ports:
      - "7777:7777/tcp"
      - "7777:7777/udp"
      - "27016:27016/tcp"
      - "27016:27016/udp"
    env_file:
      - .env
    volumes:
      - ./data:/data

You can also use the command docker run instead of docker compose. the server runs as soon as you run the command below.

docker run -d \
    --name longvinter-server \
    -p 7777:7777/tcp \
    -p 7777:7777/tcp \
    -p 27016:27016/udp \
    -p 27016:27016/udp \
    -v ./data:/data/ \
    -e TZ="UTC" \
    -e PUID=1000 \
    -e PGID=1000 \
    -e PORT=7777 \
    -e QUERY_PORT=27016 \
    -e CFG_SERVER_NAME="Unnamed Island" \
    -e CFG_MAX_PLAYERS=32 \
    -e CFG_SERVER_MOTD="Welcome to Longvinter Island!" \
    -e CFG_PASSWORD="" \
    -e CFG_COMMUNITY_WEBSITE="www.longvinter.com" \
    -e CFG_COOP_PLAY=false \
    -e CFG_COOP_SPAWN=0 \
    -e CFG_SERVER_TAG="none" \
    -e CFG_ADMIN_STEAM_ID="" \
    -e CFG_ENABLE_PVP=true \
    -e CFG_TENT_DECAY=true \
    -e CFG_MAX_TENTS=2 \
    --restart unless-stopped \
    --stop-timeout 30 \
    kimzuni/longvinter-docker-server:latest

As an alternative, you can copy the .env.example file to a new file called .env file. Modify it to your needs, check out the environment variables section to check the correct values. Change your docker run command to this:

docker run -d \
    --name longvinter-server \
    -p 7777:7777/tcp \
    -p 7777:7777/tcp \
    -p 27016:27016/udp \
    -p 27016:27016/udp \
    -v ./data:/data/ \
    --env-file .env \
    --restart unless-stopped \
    --stop-timeout 30 \
    kimzuni/longvinter-docker-server:latest

If you are running the server first, please stop:

docker stop longvinter-server
docker rm longvinter-server

Next, remove the installed image:

docker rmi $(docker images | grep -E ^"(ghcr.io\/)?kimzuni/longvinter-docker-server" | awk '{print $3}')

Finally, run the Docker Compose or Docker Run with the latest tag.

This is only for advanced users.

It is possible to run this container and override the default user which is root in this image.

Because you are specifiying the user and group PUID and PGID are ignored.

If you want to find your UID: id -u, If you want to find your GID: id -g.

You must set user to NUMBERICAL_UID:NUMBERICAL_GID.

Below we assume your UID is 1000 and your GID is 1001.

• In Docker Run add --user 1000:1001 \ above the last line.
• In Docker Compose add user: 1000:1001 above ports.

If you wish to run it with a different UID/GID than your own you will need to change the ownership of the directory that is being bind: chown UID:GID data/ or by changing the permissions for all other: chmod o=rwx data/

You can use the following values to change the settings of the server on boot. It is highly recommended you set the following environment values before starting the server:

* highly recommended to set

** Make sure you know what you are doing when running this option enabled.

Used for countdown before automatic updating/Rebooting a server.

You can broadcast manually using the command:

docker exec longvinter-server broadcast "Message" COLOR

List of color: $\color{#1132D8}Blue$(Default), $\color{#E8D44F}Yellow$, $\color{#D85311}Orange$, $\color{#DF0000}Red$, $\color{#00CC00}Green$ (Case-insensitive)

Color is used when sending to Discord. See Broadcast on Discord

To create a backup of the game's last save, use the command:

docker exec longvinter-server backup

This will create a backup at /data/Longvinter/backups/

To restore from a backup, use the command:

docker exec -it longvinter-server restore

Locate the backup you want to restore in /data/Longvinter/backups/ and decompress it. Need to stop the server before task.

docker compose down

Delete the old saved data folder located at data/Longvinter/Saved/.

Copy the contents of the newly decompressed saved data folder Saved/ to data/Longvinter/Saved/.

Restart the game. (If you are using Docker Compose)

docker compose up -d

Set BACKUP_ENABLED enable or disable automatic backups (Default is enabled)

BACKUP_CRON_EXPRESSION is a cron expression, in a Cron-Expression you define an interval for when to run jobs.

Example Usage: If BACKUP_CRON_EXPRESSION to 0 2 * * *, the backup script will run every day at 2:00 AM. This is affected by the environment variable TZ value and the default is set to run at midnight every night.

To be able to use automatic Updates with this Server the following environment variables have to be set to true:

• AUTO_UPDATE_ENABLED
• UPDATE_ON_BOOT (default is enabled)

AUTO_UPDATE_CRON_EXPRESSION is a cron expression, in a Cron-Expression you define an interval for when to run jobs.

Example Usage: If AUTO_UPDATE_CRON_EXPRESSION to 0 2 * * *, the update script will run every day at 2:00 AM. This is affected by the environment variable TZ value and the default is set to run at every hour.

Set AUTO_REBOOT_ENABLED enable or disable automatic reboots (Default is disabled)

AUTO_REBOOT_CRON_EXPRESSION is a cron expression, in a Cron-Expression you define an interval for when to run jobs.

Example Usage: If AUTO_REBOOT_CRON_EXPRESSION to 0 2 * * *, the reboot script will run every day at 2:00 AM. This is affected by the environment variable TZ value and the default is set to run at midnight every night.

Used with environment variables.

When the server starts, a Game.ini file will be created in the following location: <mount_folder>/Longvinter/Saved/Config/LinuxServer/Game.ini. By default, the Game.ini file consists of the this environment variables, but if the DISABLE_GENERATE_SETTINGS value is set to 'true', the file can be modified and set directly.

1. Generate a webhook url for your discord server in your discord's server settings.
2. Set the environment variable with the unique token at the end of the discord webhook url example: https://discord.com/api/webhooks/1234567890/abcde

Send discord messages with docker run:

-e DISCORD_WEBHOOK_URL="https://discord.com/api/webhooks/1234567890/abcde" \
-e DISCORD_PRE_UPDATE_BOOT_MESSAGE="Server is updating..." \

Send discord messages with docker compose:

- DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/1234567890/abcde
- DISCORD_PRE_UPDATE_BOOT_MESSAGE="Server is updating..."

Set DISCORD_BROADCAST_MESSAGE_ENABLE enable or disable broadcast on Discord (Default is enabled) (Recommended for use)

If you use broadcast-only Discord Channel, set the DISCORD_BROADCAST_MESSAGE_URL. If not set, DISCORD_WEBHOOK_URL will be used.

If TARGET_COMMIT_ID environment variable is set, will lock server version to specific commit. The Commit ID is a hexadecimal value found on page https://github.com/Uuvana-Studios/longvinter-linux-server/commits/main/ and please given at least 4 digits.