Dedicated server guide

San Andreas Multiplayer

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

Operator-provided prerequisites required · Support evidence: 2026-10-16.

Runtime familysteamcmd-linux

Declared runtimes: Docker or a Linux host process.

Network bindings

7777/UDP, 7777/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

Operator-provided game files, runtime or other prerequisites are required; follow the game guide before setup.

Docker

Complete interactive setup and review game-specific configuration before starting the server. Operator-provided game files, runtime or other prerequisites are required; follow the game guide before setup.

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

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

Host process

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

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

This guide covers the sampserver module in AlphaGSM.

sampserver is currently ENABLED (BYO) on the documented Ubuntu 24.04 Linux baseline. The current GitHub integration lane still exercises both process and Docker runtime selection around that direct-archive-or-staged-tree prerequisite, while local runs remain process-backed by default unless you opt into the Docker backend.

Requirements

screen
either a direct SA-MP dedicated-server archive URL or a pre-staged SA-MP Linux server tree
Python packages from requirements.txt

Quick Start

Create the server:

alphagsm mysampserv create sampserver

Run setup:

alphagsm mysampserv setup

sampserver is supported in ENABLED (BYO) mode. Before setup or start, either:

set url to a working SA-MP dedicated-server archive, or
stage samp03svr and the rest of the SA-MP server files inside your chosen <install_dir>/

Start it:

alphagsm mysampserv start

Check it:

alphagsm mysampserv status

Stop it:

alphagsm mysampserv stop

Setup Details

Setup configures:

the game port (default 7777)
the install directory
downloads and extracts the server archive when url is set

Suggested flow:

alphagsm mysampserv create sampserver
alphagsm mysampserv set url https://example.invalid/samp-server.tar.gz
alphagsm mysampserv setup -n 7777 /path/to/samp
alphagsm mysampserv start

Or, if you already have the server files:

alphagsm mysampserv create sampserver
alphagsm mysampserv setup -n 7777 /path/to/samp
## copy samp03svr and the rest of the server tree into /path/to/samp/
alphagsm mysampserv start

Useful Commands

alphagsm mysampserv update
alphagsm mysampserv backup
alphagsm mysampserv set url https://example.invalid/samp-server.tar.gz

Notes

Module name: sampserver
Default port: 7777

Server variables

After create sampserver, 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: samp03svr
Location: <install_dir>/samp03svr
Engine: Custom

Server Configuration

Config files: server.cfg
Template: See server-templates/sampserver/ if available

Maps and Mods

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

BYO file helper

Inspect this game's required files, source instructions and destinations with alphagsm <server-name> assets requirements; check the declared files with alphagsm <server-name> assets check. File checks do not establish game readiness. This helper checks known sentinels only and directs you to stage the complete compatible distribution manually; managed import is unavailable for this recipe. See BYO files and private SteamCMD acquisition.

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 San Andreas Multiplayer?

Operator-provided prerequisites required. Operator-provided game files, runtime or other prerequisites are required; follow the game guide before setup.

Which runtimes can run San Andreas Multiplayer?

Declared runtimes: Docker or a Linux host process.

Which ports does San Andreas Multiplayer use?

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

Can I add mods to San Andreas Multiplayer?

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

How should I back up San Andreas Multiplayer?

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