Dedicated server guide

Xonotic

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

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

Runtime familyquake-linux

Declared runtimes: Docker or a Linux host process.

Network bindings

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

Mods and plugins

No mod support is declared in this snapshot; review the game guide before adding mods.

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-xntserver create xntserver
Complete interactive setup ./alphagsm-docker my-xntserver setup
Start the game server ./alphagsm-docker my-xntserver start
Check the instance status ./alphagsm-docker my-xntserver status

./alphagsm-docker start
./alphagsm-docker my-xntserver create xntserver
./alphagsm-docker my-xntserver setup
./alphagsm-docker my-xntserver start
./alphagsm-docker my-xntserver 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-xntserver create xntserver
Complete interactive setup ./alphagsm my-xntserver setup
Check the host prerequisites ./alphagsm my-xntserver doctor
Start the game server ./alphagsm my-xntserver start
Check the instance status ./alphagsm my-xntserver status

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

This guide covers the xntserver module in AlphaGSM.

xntserver is currently PASSED in the checked-in support tracker on the documented Ubuntu 24.04 Linux baseline. The validated lifecycle covers the shared quake-linux Docker runtime as well as the module's Quake query / info surface. GitHub keeps one Docker-default lifecycle for this module rather than duplicating the same archive install in an unproven process lane.

Requirements

Docker for the validated container-backed Linux runtime, or a compatible local process runtime
Python packages from requirements.txt

Quick Start

Create the server:

alphagsm myxntserve create xntserver

Run setup:

alphagsm myxntserve setup

Start it:

alphagsm myxntserve start

Check it:

alphagsm myxntserve status

Stop it:

alphagsm myxntserve stop

Setup Details

Setup configures:

the game port (default 26000)
the install directory
downloads and extracts the server archive

Useful Commands

alphagsm myxntserve update
alphagsm myxntserve backup

Notes

Module name: xntserver
Default port: 26000

Server variables

After create xntserver, 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

Launcher: server/server_linux.sh
Runtime binary: xonotic-linux64-dedicated
Location: <detected_content_root>/server/server_linux.sh
Engine: Custom

AlphaGSM detects nested archive roots such as <install_dir>/Xonotic, launches the wrapper from that content root, and maps the equivalent Docker working directory. Quake readiness is checked through AlphaGSM rather than raw localhost probes, with spacing for DarkPlaces' rate limit. Replacement GitHub CI validation is pending.

Server Configuration

Config file: AlphaGSM writes the managed dedicated config to <install_dir>/data/server.cfg
Template: See server-templates/xntserver/ if available

Maps and Mods

Map directory: Check game documentation
Mod directory: Check game documentation
Workshop support: No

Configuration templates

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

server.cfg

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 Xonotic?

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

Which runtimes can run Xonotic?

Declared runtimes: Docker or a Linux host process.

Which ports does Xonotic use?

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

Can I add mods to Xonotic?

No mod support is declared in this snapshot; review the game guide before adding mods.

How should I back up Xonotic?

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