Comment créer son serveur Garry's Mod
Guide complet pour créer un serveur dédié Garry's Mod sur un VPS ou serveur dédié Linux : SteamCMD, token GSLT, gamemode, collection Workshop, administrateurs, RCON et service systemd.
Sur cette page
Vos valeurs
Renseignez-les une fois, les commandes du guide se mettent à jour.
Ce guide vous explique comment installer et configurer un serveur dédié Garry's Mod sur votre VPS ou serveur dédié Linux : token GSLT, choix du gamemode, collection Workshop, administrateurs, RCON et service systemd.
Commander un serveur
Pour héberger votre serveur Garry's Mod, HostMyServers propose plusieurs offres adaptées au gaming. Le moteur Source sollicite surtout un seul cœur : privilégiez un processeur à fréquence élevée.
- VPS Performance - Ressources dédiées et processeurs rapides, idéal pour Garry's Mod
- VPS NVMe - Pour un petit serveur ou un serveur de test
- Serveurs dédiés Eco - Pour héberger plusieurs serveurs de jeux
- Serveurs dédiés Performance - Performance maximale
Prérequis
- Accès SSH root ou utilisateur avec sudo
- Système Linux 64 bits (Debian 12/13 ou Ubuntu 22.04/24.04 recommandé)
- Pare-feu actif : nftables (recommandé), iptables ou ufw (n'utilisez qu'un seul outil de pare-feu à la fois)
- Un compte Steam possédant Garry's Mod, pour créer le token GSLT
- Port 27015 UDP accessible, et port 27015 TCP (RCON) accessible depuis votre adresse IP fixe uniquement
Configuration requise
Facepunch ne publie pas de configuration officielle pour le serveur. Ces valeurs sont des estimations pour un serveur Sandbox, à ajuster selon le nombre de joueurs et d'addons.
| Composant | Minimum | Recommandé |
|---|---|---|
| RAM | 2 Go | 4 Go et plus |
| CPU | 2 cœurs | 4 cœurs à fréquence élevée |
| Stockage | 10 Go | 30 Go SSD NVMe, davantage avec le Workshop |
| Réseau | 100 Mbps | 1 Gbps |
Mise à jour du système
sudo apt update && sudo apt upgrade -yInstallation des dépendances
SteamCMD et la version par défaut du serveur sont des programmes 32 bits. Activez l'architecture i386 puis installez les bibliothèques nécessaires :
sudo dpkg --add-architecture i386
sudo apt update
sudo apt install -y wget tar git lib32gcc-s1 lib32stdc++6 lib32z1 libtinfo6:i386 libncurses6:i386Création d'un utilisateur dédié
Le serveur ne doit jamais tourner en root :
sudo adduser --disabled-password --gecos "" gmodPorts utilisés
| Port | Protocole | Utilisation |
|---|---|---|
| 27015 | UDP | Jeu et requêtes de la liste des serveurs |
| 27015 | TCP | RCON (administration à distance), à limiter à votre adresse IP |
Configuration du pare-feu
Ouvrez le port de jeu pour tous, et limitez le RCON à votre adresse IP fixe : remplacez VOTRE_IP.
Avec UFW
sudo ufw allow 27015/udp
sudo ufw allow from VOTRE_IP to any port 27015 proto tcp
sudo ufw reloadAvec iptables
sudo iptables -A INPUT -p udp --dport 27015 -j ACCEPT
sudo iptables -A INPUT -p tcp -s VOTRE_IP --dport 27015 -j ACCEPT
sudo iptables-save | sudo tee /etc/iptables/rules.v4La sauvegarde des règles au redémarrage nécessite le paquet iptables-persistent.
Avec nftables
Ces commandes utilisent la table inet filter et la chaîne input, présentes par défaut dans /etc/nftables.conf sous Debian.
sudo nft add rule inet filter input udp dport 27015 accept
sudo nft add rule inet filter input ip saddr VOTRE_IP tcp dport 27015 accept
(echo "flush ruleset"; sudo nft list ruleset) | sudo tee /etc/nftables.confInstallation de SteamCMD
Ouvrez une session avec l'utilisateur gmod :
sudo -iu gmodCréez les répertoires et téléchargez SteamCMD :
mkdir -p ~/steamcmd ~/gmod-server
cd ~/steamcmd
wget https://steamcdn-a.akamaihd.net/client/installer/steamcmd_linux.tar.gz
tar -xzf steamcmd_linux.tar.gzTéléchargement du serveur
Lancez l'installation du serveur (identifiant d'application 4020) :
./steamcmd.sh +force_install_dir /home/gmod/gmod-server +login anonymous +app_update 4020 validate +quitÀ la fin, le message Success! App '4020' fully installed. s'affiche.
Créer le token GSLT
Facepunch demande un token GSLT (Game Server Login Token) pour chaque serveur. Sans token, le serveur est fortement pénalisé dans le classement de la liste des serveurs.
- Ouvrez la page Gestion des comptes de serveur de jeu Steam
- Dans App ID du jeu de base, saisissez 4000 (et non 4020)
- Ajoutez un mémo pour identifier le serveur, puis cliquez sur Créer
- Copiez le token obtenu
Le compte Steam ne doit pas être limité, banni de la communauté ou verrouillé. Il doit disposer d'un numéro de téléphone éligible et posséder Garry's Mod.
Configuration du serveur
Fichier server.cfg
nano ~/gmod-server/garrysmod/cfg/server.cfghostname "Mon serveur Garry's Mod"
sv_password ""
rcon_password "ChangezMoi"
sv_region 3
sv_lan 0
// Limites du mode Sandbox
sbox_maxprops 200
sbox_maxragdolls 10
sbox_maxvehicles 4
sbox_maxnpcs 10
sbox_godmode 0
sbox_playershurtplayers 1
// Listes de bannissement
exec banned_user.cfg
exec banned_ip.cfgProtégez le fichier, car il contient le mot de passe RCON :
chmod 600 ~/gmod-server/garrysmod/cfg/server.cfg| Paramètre | Description |
|---|---|
hostname |
Nom public du serveur |
sv_password |
Mot de passe pour rejoindre (vide = public) |
rcon_password |
Mot de passe du RCON |
sv_region |
Région de la liste des serveurs (3 = Europe) |
sv_lan |
0 = serveur visible sur Internet |
sbox_maxprops |
Nombre maximum d'objets par joueur |
sbox_maxragdolls |
Nombre maximum de ragdolls par joueur |
sbox_maxvehicles |
Nombre maximum de véhicules par joueur |
sbox_maxnpcs |
Nombre maximum de PNJ par joueur |
sbox_godmode |
1 = joueurs invincibles |
sbox_playershurtplayers |
1 = les joueurs peuvent se blesser entre eux |
Script de lancement
Le script regroupe les paramètres de démarrage et le token :
nano ~/gmod-server/start.sh#!/bin/bash
cd /home/gmod/gmod-server
exec ./srcds_run -game garrysmod -console -norestart \
-port 27015 \
+maxplayers 32 \
+gamemode sandbox \
+map gm_construct \
+sv_setsteamaccount VOTRE_TOKEN_GSLTRemplacez VOTRE_TOKEN_GSLT, puis limitez l'accès au script :
chmod 700 ~/gmod-server/start.sh| Paramètre | Description |
|---|---|
-game garrysmod |
Jeu à lancer (obligatoire) |
-console |
Mode console |
-norestart |
Laisse systemd gérer les redémarrages |
-port |
Port du serveur |
+maxplayers |
Nombre maximum de joueurs |
+gamemode |
Gamemode chargé au démarrage |
+map |
Carte de démarrage |
+host_workshop_collection |
Collection Workshop à charger |
+sv_setsteamaccount |
Token GSLT |
Premier lancement
~/gmod-server/start.shLe serveur est prêt quand la console indique qu'il est connecté aux serveurs Steam. Tapez quit pour l'arrêter, puis quittez la session de l'utilisateur gmod :
exitConfiguration en tant que service systemd
Créer le fichier de service
sudo nano /etc/systemd/system/gmod.service[Unit]
Description=Garry's Mod Dedicated Server
Wants=network-online.target
After=network-online.target
[Service]
Type=simple
User=gmod
Group=gmod
WorkingDirectory=/home/gmod/gmod-server
Environment=TERM=xterm
ExecStart=/home/gmod/gmod-server/start.sh
LimitNOFILE=2048
Restart=on-failure
RestartSec=20
[Install]
WantedBy=multi-user.targetActiver et démarrer le service
sudo systemctl daemon-reload
sudo systemctl enable gmod.service
sudo systemctl start gmod.serviceCommandes de gestion
# Vérifier le statut
sudo systemctl status gmod.service
# Arrêter le serveur
sudo systemctl stop gmod.service
# Redémarrer le serveur
sudo systemctl restart gmod.service
# Voir les logs
sudo journalctl -u gmod.service -fVérifier le fonctionnement
sudo systemctl is-active gmod.service
sudo ss -ulnp | grep 27015Le service doit être active et le port 27015 à l'écoute. Connectez-vous ensuite depuis le jeu pour confirmer l'accès.
Connexion au serveur
- Lancez Garry's Mod
- Activez la console dans les options du jeu, puis ouvrez-la
- Tapez :
connect IP_DU_SERVEUR:27015 - Si un mot de passe est configuré, tapez d'abord :
password VotreMotDePasse
Vous pouvez aussi ajouter le serveur dans les favoris de Steam (menu Affichage, Serveurs, onglet Favoris).
Choisir un gamemode
Le gamemode se définit avec +gamemode dans start.sh. Sa valeur correspond au nom du dossier dans garrysmod/gamemodes/, en respectant la casse. Après chaque changement, redémarrez le service.
| Gamemode | Valeur | Remarque |
|---|---|---|
| Sandbox | sandbox |
Inclus, mode par défaut |
| Trouble in Terrorist Town | terrortown |
Inclus, nécessite le contenu de Counter-Strike: Source et une carte ttt_ |
| DarkRP | darkrp |
Projet tiers, à installer |
Trouble in Terrorist Town
Téléchargez le contenu de Counter-Strike: Source avec l'utilisateur gmod (identifiant 232330) :
sudo -iu gmod
cd ~/steamcmd
./steamcmd.sh +force_install_dir /home/gmod/css-content +login anonymous +app_update 232330 validate +quit
nano ~/gmod-server/garrysmod/cfg/mount.cfgDéclarez ce contenu dans mount.cfg :
"mountcfg"
{
"cstrike" "/home/gmod/css-content/cstrike"
}Modifiez ensuite le script de lancement, puis quittez la session et redémarrez le serveur :
nano ~/gmod-server/start.sh
exit
sudo systemctl restart gmod.serviceDans start.sh, utilisez +gamemode terrortown et une carte ttt_ présente sur le serveur, par exemple issue de votre collection Workshop. Les joueurs sans le contenu de Counter-Strike: Source verront des textures et des modèles manquants.
DarkRP
Installez le gamemode depuis son dépôt officiel :
sudo -iu gmod
git clone https://github.com/FPtje/DarkRP.git ~/gmod-server/garrysmod/gamemodes/darkrp
nano ~/gmod-server/start.sh
exit
sudo systemctl restart gmod.serviceDans start.sh, utilisez +gamemode darkrp. Ne modifiez pas les fichiers du dépôt : le projet indique comment personnaliser le gamemode et fournir son contenu aux joueurs.
Ajouter une collection Workshop
Créer la collection
- Sur le Workshop de Garry's Mod, créez une collection et ajoutez-y vos addons
- Réglez sa visibilité sur Public ou Non répertorié : une collection privée n'est pas accessible au serveur
- Relevez l'identifiant à la fin de son adresse (
?id=...)
Charger la collection
Ouvrez le script de lancement :
sudo -u gmod nano /home/gmod/gmod-server/start.shAjoutez cette ligne avant +sv_setsteamaccount, en remplaçant ID_COLLECTION :
+host_workshop_collection ID_COLLECTION \Puis redémarrez le serveur :
sudo systemctl restart gmod.serviceLe serveur télécharge la collection et ses sous-collections au démarrage, et vérifie les mises à jour à chaque redémarrage. Pour désactiver ces mises à jour, ajoutez host_workshop_autoupdate 0 dans server.cfg. Attention : un serveur resté sur une ancienne version d'une carte peut empêcher les joueurs de se connecter.
Lister des addons sans collection
Depuis la version 2026.09.22 du jeu, vous pouvez aussi déclarer des addons dans garrysmod/cfg/srcds_workshop_ids.txt, à créer vous-même :
"my_workshop_addons"
{
"1"
{
"wsid" "123277559"
}
"2"
{
"wsid" "111412589"
}
}Faire télécharger le contenu aux joueurs
Les cartes de la collection et le gamemode lié au Workshop sont proposés automatiquement aux joueurs. Pour un autre addon contenant des modèles, des textures ou des sons, créez ce fichier :
sudo -u gmod mkdir -p /home/gmod/gmod-server/garrysmod/lua/autorun/server
sudo -u gmod nano /home/gmod/gmod-server/garrysmod/lua/autorun/server/workshop.luaresource.AddWorkshop( "ID_ADDON" )Ajoutez une ligne par addon. Il est inutile de le faire pour un addon composé uniquement de code Lua, et l'identifiant d'une collection n'est pas accepté ici.
Administration
Ajouter des administrateurs
Récupérez d'abord le SteamID du joueur (au format STEAM_0:X:XXXXXXXX) avec la commande status, une fois qu'il est connecté. Modifiez ensuite la liste des utilisateurs :
sudo -u gmod nano /home/gmod/gmod-server/garrysmod/settings/users.txt"Users"
{
"superadmin"
{
"VotrePseudo" "STEAM_0:X:XXXXXXXX"
}
"admin"
{
"UnModerateur" "STEAM_0:X:XXXXXXXX"
}
}Redémarrez le serveur pour appliquer la liste. À la connexion, un message confirme le groupe du joueur. Steam doit avoir authentifié le joueur : si le groupe n'est pas appliqué, relancez Steam et reconnectez-vous.
Le jeu ne fournit pas de menu complet d'administration. Pour en ajouter un, vous pouvez installer les addons tiers ULib et ULX dans garrysmod/addons/.
Utiliser le RCON
Votre adresse IP doit être autorisée sur le port TCP 27015. Dans la console du jeu :
rcon_address IP_DU_SERVEUR:27015
rcon_password VotreMotDePasse
rcon status| Commande | Description |
|---|---|
status |
Affiche les joueurs connectés et leur SteamID |
changelevel <carte> |
Changer de carte |
kickid <userid> |
Expulser un joueur |
banid <minutes> <steamid> kick |
Bannir un joueur (0 = définitif) |
removeid <steamid> |
Retirer un bannissement |
writeid |
Enregistrer les bannissements dans banned_user.cfg |
say <message> |
Envoyer un message à tous les joueurs |
exec server.cfg |
Recharger la configuration |
quit |
Arrêter le serveur |
Mise à jour du serveur
Arrêtez le serveur, sauvegardez vos fichiers de configuration, puis mettez à jour :
sudo systemctl stop gmod.service
sudo -iu gmod
cp ~/gmod-server/garrysmod/cfg/server.cfg ~/server.cfg.bak
cp ~/gmod-server/garrysmod/settings/users.txt ~/users.txt.bak
cd ~/steamcmd
./steamcmd.sh +force_install_dir /home/gmod/gmod-server +login anonymous +app_update 4020 +quit
exit
sudo systemctl start gmod.serviceSi vous avez installé DarkRP, mettez-le aussi à jour avec git -C ~/gmod-server/garrysmod/gamemodes/darkrp pull, depuis la session de l'utilisateur gmod.
Sauvegarde automatique
Script de sauvegarde
sudo nano /home/gmod/backup.sh#!/bin/bash
umask 077
BACKUP_DIR="/home/gmod/backups"
GAME_DIR="/home/gmod/gmod-server/garrysmod"
DATE=$(date +%Y-%m-%d_%H-%M-%S)
mkdir -p "$BACKUP_DIR"
cd "$GAME_DIR" || exit 1
# Conserver uniquement les éléments présents
ITEMS=()
for item in cfg settings data addons sv.db lua/autorun/server; do
[ -e "$item" ] && ITEMS+=("$item")
done
tar -czf "$BACKUP_DIR/gmod_$DATE.tar.gz" "${ITEMS[@]}"
# Supprimer les sauvegardes de plus de 7 jours
find "$BACKUP_DIR" -name "gmod_*.tar.gz" -mtime +7 -delete
echo "Sauvegarde terminée : gmod_$DATE.tar.gz"sudo chown gmod:gmod /home/gmod/backup.sh
sudo chmod 700 /home/gmod/backup.shLe fichier sv.db est la base SQLite du serveur : de nombreux addons et gamemodes y stockent leurs données.
Planifier la sauvegarde
Pour obtenir une base cohérente, cette tâche arrête le serveur pendant la sauvegarde puis le relance :
sudo crontab -e# Sauvegarde et redémarrage tous les jours à 5h
0 5 * * * systemctl stop gmod.service; sudo -u gmod /home/gmod/backup.sh; systemctl start gmod.serviceEn cas de problème
Le serveur ne démarre pas
-
Consultez les logs :
sudo journalctl -u gmod.service -n 100 -
Vérifiez que le token GSLT est valide, n'a pas expiré et a été créé avec l'App ID 4000
-
Vérifiez que
start.shest exécutable :sudo -u gmod ls -l /home/gmod/gmod-server/start.sh -
Recherchez une bibliothèque manquante :
Terminalsudo -u gmod bash -c 'cd ~/gmod-server && LD_LIBRARY_PATH=.:bin ldd srcds_linux | grep "not found"'
linux32/steamcmd: No such file or directory
Ce message indique en général que les bibliothèques 32 bits manquent, alors que le fichier existe. Installez-les :
sudo apt install -y lib32gcc-s1Avertissement libtinfo.so.5 ou libncurses.so.5
Les versions récentes de Debian et d'Ubuntu ne fournissent plus ces anciennes bibliothèques. Créez des liens vers les versions 6 :
sudo ln -sf /usr/lib/i386-linux-gnu/libtinfo.so.6 /usr/lib/i386-linux-gnu/libtinfo.so.5
sudo ln -sf /usr/lib/i386-linux-gnu/libncurses.so.6 /usr/lib/i386-linux-gnu/libncurses.so.5Erreur steamclient.so
Créez le lien vers le fichier 32 bits de SteamCMD :
sudo -u gmod mkdir -p /home/gmod/.steam/sdk32
sudo -u gmod ln -sf /home/gmod/steamcmd/linux32/steamclient.so /home/gmod/.steam/sdk32/steamclient.soLes joueurs ne peuvent pas se connecter
-
Vérifiez que le port 27015 est ouvert en UDP :
Terminalsudo ufw status sudo iptables -L INPUT -n --line-numbers | grep 27015 sudo nft list ruleset | grep 27015 -
Vérifiez que le serveur écoute :
sudo ss -ulnp | grep 27015 -
Attendez la fin du téléchargement du Workshop au démarrage
Le serveur n'apparaît pas dans la liste
- Vérifiez que
sv_lan 0est défini dansserver.cfg - Vérifiez que le token GSLT est bien pris en compte dans les logs
- Patientez quelques minutes après le démarrage
La collection Workshop ne se télécharge pas
- Vérifiez que la collection est publique ou non répertoriée
- Vérifiez l'identifiant dans
start.sh - Vérifiez l'espace disque :
df -h
Textures violettes ou modèles ERROR
Le contenu manque côté joueur. Ajoutez l'addon avec resource.AddWorkshop, ou vérifiez mount.cfg si le contenu vient d'un autre jeu.
Le gamemode ou un addon n'est pas chargé
Linux distingue les majuscules des minuscules. Le nom passé à +gamemode doit correspondre exactement au dossier. Pour les anciens addons installés à la main, utilisez uniquement des minuscules dans le nom du dossier et adaptez les chemins Lua qui s'y réfèrent.
FAQ
Faut-il ouvrir des ports pour Steam ?
Si votre pare-feu bloque le trafic entrant par défaut, ces règles permettent au serveur de recevoir les réponses des serveurs Steam :
UFW :
sudo ufw allow proto udp from any port 27000:27030 to any port 1025:65535
sudo ufw allow proto udp from any port 4380 to any port 1025:65535
sudo ufw reloadiptables :
sudo iptables -A INPUT -p udp -m udp --sport 27000:27030 --dport 1025:65535 -j ACCEPT
sudo iptables -A INPUT -p udp -m udp --sport 4380 --dport 1025:65535 -j ACCEPT
sudo iptables-save | sudo tee /etc/iptables/rules.v4nftables :
sudo nft add rule inet filter input udp sport 27000-27030 udp dport 1025-65535 accept
sudo nft add rule inet filter input udp sport 4380 udp dport 1025-65535 accept
(echo "flush ruleset"; sudo nft list ruleset) | sudo tee /etc/nftables.confExiste-t-il une version 64 bits du serveur ?
Facepunch propose une branche x86-64, que ce guide ne couvre pas. Comme toute branche de développement, elle est mise à jour régulièrement et peut être moins stable. Consultez le wiki de Garry's Mod avant de l'utiliser.
Puis-je héberger plusieurs serveurs sur la même machine ?
Oui. Utilisez un dossier, un port (-port 27016, à ouvrir dans le pare-feu), un service systemd et un token GSLT distincts pour chaque serveur.