Dedicated server guide

Unturned

Manage unturned with AlphaGSM. Choose a runtime supported by the recorded module capabilities.

Recorded lifecycle pass · Support evidence: 2026-10-16.

Anonymous Workshop Process and Docker load passed for public dedicated-server content. Mod installation explains add, apply, and cleanup.

Build setup commands

Runtime familysteamcmd-linux

Declared runtimes: Docker or a Linux host process.

Network bindings

27015/UDP, 27016/UDP. Named port values remain unknown; review the game guide and configuration for additional requirements.

Mods and plugins

For Workshop content, use the setup builder with an actual game-compatible item ID; review supported content types in the guide. Anonymous Steam Workshop content for this module passed both process and Docker load. After setup, record an item with mod add workshop using a numeric ID or Steam Workshop URL, then run mod apply.

Backup hook

A module-specific backup hook is declared. Review the game guide for its scope, restore procedure and shutdown requirements.

Choose a supported runtime

Linux and Docker quickstart

Review the game guide for installation, account, licensing and runtime prerequisites before setup.

Docker

Complete interactive setup and review game-specific configuration before starting the server. Review the game guide for installation, account, licensing and runtime prerequisites before setup.

Start the Docker manager ./alphagsm-docker start
Create the game instance ./alphagsm-docker my-unturned create unturned
Complete interactive setup ./alphagsm-docker my-unturned setup
Start the game server ./alphagsm-docker my-unturned start
Check the instance status ./alphagsm-docker my-unturned status

./alphagsm-docker start
./alphagsm-docker my-unturned create unturned
./alphagsm-docker my-unturned setup
./alphagsm-docker my-unturned start
./alphagsm-docker my-unturned status

Host process

Complete interactive setup and review game-specific configuration before starting the server. Review the game guide for installation, account, licensing and runtime prerequisites before setup.

Create the game instance ./alphagsm my-unturned create unturned
Complete interactive setup ./alphagsm my-unturned setup
Check the host prerequisites ./alphagsm my-unturned doctor
Start the game server ./alphagsm my-unturned start
Check the instance status ./alphagsm my-unturned status

./alphagsm my-unturned create unturned
./alphagsm my-unturned setup
./alphagsm my-unturned doctor
./alphagsm my-unturned start
./alphagsm my-unturned status

This guide covers the unturned module in AlphaGSM.

unturned is currently PASSED in the checked-in support tracker on the documented Ubuntu 24.04 Linux baseline. The current GitHub integration lane validates both process and Docker runtimes for this module, while local runs remain process-backed by default unless you opt into the Docker backend.

Requirements

screen
SteamCMD runtime libraries (lib32gcc-s1, lib32stdc++6)
Python packages from requirements.txt

Quick Start

Create the server:

alphagsm myunturned create unturned

Run setup:

alphagsm myunturned setup

Start it:

alphagsm myunturned start

Check it:

alphagsm myunturned status

Stop it:

alphagsm myunturned stop

Setup Details

Setup configures:

the game port (default 27015)
the install directory
SteamCMD downloads the server files

AlphaGSM writes native settings to Servers/<serverid>/Server/Commands.dat. The configured base port is used for Steam A2S queries; gameplay uses the next UDP port. Open both ports when configuring your firewall.

Useful Commands

alphagsm myunturned update
alphagsm myunturned backup

Steam Workshop Content

Add an Unturned Workshop item by ID or Steam Community URL, or expand a collection into validated item IDs:

alphagsm myunturned mod add workshop 2396897717
alphagsm myunturned mod add workshop-collection COLLECTION_ID_OR_URL
alphagsm myunturned mod list
alphagsm myunturned mod apply

AlphaGSM checks each item's game identity against Unturned's Workshop AppID 304930, separately from the dedicated-server download AppID 1110390. Applying content writes integer File_IDs in Servers/<serverid>/WorkshopDownloadConfig.json. Setup and prestart apply desired content automatically. Unturned downloads the items and dependencies during its next startup and supplies required content to connecting players, as described in the official server hosting guide. Restart a running server after applying changes.

For a Workshop map, also select its exact map name with a Map line in Servers/<serverid>/Server/Commands.dat. For example, item 2396897717 is PEI Arena; replace any existing Map line with Map PEI Arena. mod apply configures startup activation; download or config-file presence alone does not prove the running engine has loaded the content. Check the live map with alphagsm myunturned info --json.

Remove a managed item from activation:

alphagsm myunturned mod remove workshop 2396897717
alphagsm myunturned mod apply

Choose another map before restarting if the removed item supplied the selected map. mod cleanup removes AlphaGSM's native activation entries. Existing operator IDs and unrelated JSON settings are preserved, and the engine's download cache is left intact. An anonymously installable dedicated server does not guarantee access to every Workshop item; inaccessible metadata or content remains a failure to resolve or load.

Notes

Module name: unturned
Default port: 27015

Server variables

After create unturned, inspect or change these with set:

alphagsm myserver set --list
alphagsm myserver set KEY --describe
alphagsm myserver set KEY VALUE

This module does not declare schema-backed keys. set --list after create is still the live source of truth.

Developer Notes

Run File

Executable: ServerHelper.sh
Location: <install_dir>/ServerHelper.sh
Engine: Custom (SteamCMD)
SteamCMD App ID: 1110390

Server Configuration

Config files: Servers/<serverid>/Server/Commands.dat and Servers/<serverid>/WorkshopDownloadConfig.json
Template: See server-templates/unturned/ if available

Maps and Mods

Built-in map directory: Maps/
Native Workshop cache: Servers/<serverid>/Workshop/Steam/
Workshop support: Native WorkshopDownloadConfig.json activation through mod

Workshop Load Validation

The optional Workshop integration cases use a fresh install and the retired Workshop-only PEI Arena map. They require an A2S response naming that map, then prove shutdown and managed activation removal. Both process and Docker cases run the lifecycle through AlphaGSM commands:

PYTHONPATH=.:src ALPHAGSM_RUN_INTEGRATION=1 ALPHAGSM_RUN_STEAMCMD=1 ALPHAGSM_RUN_WORKSHOP=1 \
  python -m pytest tests/integration_tests/test_unturned.py -k workshop -v

Docker requires a working daemon and a SteamCMD Linux runtime image. Prefer a branch-local build selected with ALPHAGSM_BACKEND_DOCKER_IMAGE_STEAMCMD_LINUX. For the process smoke runner:

ALPHAGSM_RUN_WORKSHOP=1 make smoke-test SMOKE_TEST=run_unturned.sh

These are opt-in verification paths; the base module's PASSED status is not evidence that a Workshop load test has passed on your host.

Configuration templates

Reference files from this source revision. Review paths, passwords and game-specific settings before use.

Share your server

Sector Alpha server directory

When your server is ready, you can publish its connection details and community information on Sector Alpha. Review your listing and keep the information current.

Find a community

Browse the directory for game servers and their published connection details.

Browse server directory

Publish your server

Prepare a name, address and description for your listing.

Publish a server

Manual server sharing instructions

Frequently asked questions

What support evidence is recorded for Unturned?

Recorded lifecycle pass. Review the game guide for installation, account, licensing and runtime prerequisites before setup.

Which runtimes can run Unturned?

Declared runtimes: Docker or a Linux host process.

Which ports does Unturned use?

27015/UDP, 27016/UDP. Named port values remain unknown; review the game guide and configuration for additional requirements.

Can I add mods to Unturned?

How should I back up Unturned?

A module-specific backup hook is declared. Review the game guide for its scope, restore procedure and shutdown requirements.

Source and support evidence

This guide mirrors AlphaGSM’s upstream documentation at 32cef5ba9e03053c8e461fffa0ba133b160b528d. Commands and prerequisites can change. Check current support notes before installation.

All game guides