FR

Serveurs de jeux

Comment créer un serveur Project Zomboid

Guide complet pour créer un serveur dédié Project Zomboid sur un VPS ou serveur dédié Linux : installation avec SteamCMD, mémoire, compte admin, mods Workshop, service systemd et sauvegardes.

11 min de lecture, mis à jour le 18 novembre 2026

Sur cette page

Vos valeurs

Renseignez-les une fois, les commandes du guide se mettent à jour.

Ce guide vous explique comment installer un serveur dédié Project Zomboid sur votre VPS ou serveur dédié Linux, régler sa mémoire, administrer les joueurs et ajouter des mods du Steam Workshop. The Indie Stone, le studio du jeu, fournit une version Linux native du serveur, avec son propre environnement Java.

Commander un serveur

Pour héberger votre serveur Project Zomboid, HostMyServers propose plusieurs offres adaptées :

Prérequis

  • Accès SSH root ou utilisateur avec sudo
  • Système Linux 64 bits x86_64 (Debian 12/13 ou Ubuntu 22.04/24.04)
  • Pare-feu actif : nftables, iptables ou ufw (n'utilisez qu'un seul outil à la fois)
  • Environ 20 Go d'espace disque libre (SSD NVMe recommandé)
  • Ports 16261 et 16262 UDP accessibles
  • Le jeu Project Zomboid sur Steam, dans la même version que le serveur

Configuration requise

The Indie Stone ne publie pas de configuration minimale pour le serveur. Les valeurs ci-dessous sont des repères pour une partie sans mods : les mods, la taille de la carte explorée et le nombre de zombies augmentent la consommation.

Joueurs CPU Valeur -Xmx RAM du serveur
1 à 4 2 cœurs rapides 4g 8 Go
5 à 10 4 cœurs rapides 6g 12 Go
11 à 20 4 cœurs rapides 8g 16 Go
21 à 32 6 cœurs ou plus 12g 24 Go

Le serveur occupe environ 7 Go sur le disque, sans compter les mods et les sauvegardes.

Mise à jour du système

Terminal
sudo apt update && sudo apt upgrade -y

Installation des dépendances

Java est fourni avec le serveur, inutile de l'installer. lib32gcc-s1 est nécessaire à SteamCMD :

Terminal
sudo apt install -y curl tar ca-certificates lib32gcc-s1 libstdc++6

Création d'un utilisateur dédié

Le serveur ne doit jamais tourner en root. Créez un utilisateur dédié :

Terminal
sudo adduser --disabled-password --gecos "" zomboid

Ports utilisés

Port Protocole Paramètre Utilisation Accès
16261 UDP DefaultPort Jeu Public
16262 UDP UDPPort Jeu Public
27015 TCP RCONPort RCON, désactivé par défaut Votre adresse IP uniquement, si vous l'activez

Le RCON ne démarre que si RCONPassword est renseigné. Si vous n'en avez pas besoin, laissez-le vide et n'ouvrez pas le port 27015.

Configuration du pare-feu

Avec UFW

Terminal
sudo ufw allow 16261/udp
sudo ufw allow 16262/udp
sudo ufw reload

Avec iptables

Terminal
sudo iptables -A INPUT -p udp --dport 16261 -j ACCEPT
sudo iptables -A INPUT -p udp --dport 16262 -j ACCEPT
sudo iptables-save | sudo tee /etc/iptables/rules.v4

La 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.

Terminal
sudo nft add rule inet filter input udp dport 16261 accept
sudo nft add rule inet filter input udp dport 16262 accept
(echo "flush ruleset"; sudo nft list ruleset) | sudo tee /etc/nftables.conf

Installation de SteamCMD

Connectez-vous en tant qu'utilisateur zomboid et préparez les dossiers :

Terminal
sudo -iu zomboid
mkdir -p ~/steamcmd ~/pz-server
cd ~/steamcmd
curl -sqL "https://steamcdn-a.akamaihd.net/client/installer/steamcmd_linux.tar.gz" | tar -xzf -

Téléchargement du serveur

Une mise à jour peut remplacer le fichier qui contient le réglage de la mémoire. Ce script installe le serveur (identifiant d'application 380870) et réapplique votre valeur à chaque fois :

Terminal
nano ~/update-server.sh
Terminal
#!/bin/bash
set -euo pipefail

# Mémoire maximale de Java : adaptez cette valeur
XMX="6g"

"$HOME/steamcmd/steamcmd.sh" +force_install_dir /home/zomboid/pz-server +login anonymous +app_update 380870 validate +quit
sed -i "s/-Xmx[0-9]*[gGmM]/-Xmx$XMX/" /home/zomboid/pz-server/ProjectZomboid64.json
grep -- '-Xmx' /home/zomboid/pz-server/ProjectZomboid64.json
Terminal
chmod +x ~/update-server.sh
~/update-server.sh

Si SteamCMD s'arrête sur une erreur, relancez le script.

Réglage de la mémoire

La mémoire maximale de Java se règle avec -Xmx dans ProjectZomboid64.json. Le fichier fourni utilise -Xmx8g, et le script ci-dessus le remplace par la valeur de XMX.

Laissez au moins 2 Go de RAM au système et au reste de Java : sur une machine de 8 Go, ne dépassez pas -Xmx6g, et prévoyez moins si d'autres services y tournent.

Pour changer la valeur, arrêtez le serveur, modifiez XMX dans /home/zomboid/update-server.sh, relancez ce script avec l'utilisateur zomboid, puis redémarrez le serveur.

Premier lancement

Le premier lancement crée le compte admin et les fichiers de configuration. Il doit se faire dans votre session, car le serveur demande un mot de passe. Toujours avec l'utilisateur zomboid :

Terminal
~/pz-server/start-server.sh -servername servertest

Choisissez le mot de passe administrateur lorsque ces messages apparaissent :

Texte
Enter new administrator password:
Confirm the password:

Attendez le message *** SERVER STARTED ****, puis tapez cette commande dans la console pour enregistrer et arrêter le serveur :

Texte
quit

Quittez ensuite la session de l'utilisateur zomboid :

Terminal
exit

Configuration du serveur

Les réglages se trouvent dans /home/zomboid/Zomboid/Server/. Le nom des fichiers dépend de -servername, ici servertest :

Fichier Contenu
servertest.ini Réglages du serveur
servertest_SandboxVars.lua Règles de la partie (zombies, loot, durée des jours)
servertest_spawnregions.lua Zones d'apparition

Serveur arrêté, modifiez les réglages :

Terminal
sudo -u zomboid nano /home/zomboid/Zomboid/Server/servertest.ini
Paramètre Description Valeur par défaut
PublicName Nom du serveur My PZ Server
PublicDescription Description du serveur vide
Public Affiche le serveur dans la liste du jeu false
Password Mot de passe demandé pour rejoindre vide
Open Permet de rejoindre sans compte déjà créé true
MaxPlayers Nombre maximum de joueurs 32
PauseEmpty Arrête le temps quand personne n'est connecté true
DefaultPort Premier port du jeu 16261
UDPPort Second port du jeu 16262
UPnP Tente d'ouvrir les ports sur une box, inutile sur un serveur true
RCONPort Port du RCON 27015
RCONPassword Mot de passe du RCON, vide pour le désactiver vide

Voici un exemple de valeurs à modifier :

Configuration
PublicName=Mon serveur Project Zomboid
Password=ChangezCeMotDePasse
MaxPlayers=16
UPnP=false

Configuration en tant que service systemd

Le serveur s'arrête proprement avec la commande quit, envoyée sur son entrée standard. Un canal de commande, /run/zomboid.control, permet à systemd et à vous-même de lui parler.

Créer le canal de commande

Terminal
sudo nano /etc/systemd/system/zomboid.socket
Configuration
[Unit]
BindsTo=zomboid.service

[Socket]
ListenFIFO=/run/zomboid.control
FileDescriptorName=control
RemoveOnStop=true
SocketMode=0660
SocketUser=zomboid
SocketGroup=zomboid

Créer le fichier de service

Terminal
sudo nano /etc/systemd/system/zomboid.service
Configuration
[Unit]
Description=Project Zomboid Dedicated Server
After=network-online.target zomboid.socket
Wants=network-online.target
Requires=zomboid.socket

[Service]
Type=simple
User=zomboid
Group=zomboid
WorkingDirectory=/home/zomboid/pz-server
ExecStart=/home/zomboid/pz-server/start-server.sh -servername servertest
Sockets=zomboid.socket
StandardInput=socket
StandardOutput=journal
StandardError=journal
ExecStop=/bin/sh -c 'echo quit > /run/zomboid.control; while kill -0 "$$MAINPID" 2>/dev/null; do sleep 1; done'
TimeoutStopSec=180
Restart=on-failure
RestartSec=20
LimitNOFILE=100000

[Install]
WantedBy=multi-user.target

Activer et démarrer le service

Terminal
sudo systemctl daemon-reload
sudo systemctl enable zomboid.service
sudo systemctl start zomboid.service

Commandes de gestion

Terminal
# Vérifier le statut
sudo systemctl status zomboid.service

# Arrêter le serveur (enregistre le monde)
sudo systemctl stop zomboid.service

# Redémarrer le serveur
sudo systemctl restart zomboid.service

# Voir les logs
sudo journalctl -u zomboid.service -f

Vérifier le serveur

Attendez le message de démarrage, qui peut prendre plusieurs minutes :

Terminal
sudo journalctl -u zomboid.service | grep 'SERVER STARTED'

Vérifiez ensuite que les ports écoutent :

Terminal
sudo ss -ulpn | grep -E ':(16261|16262)\b'

Connexion au serveur

  1. Lancez Project Zomboid, dans la même version que le serveur.
  2. Ouvrez Join dans le menu principal.
  3. Renseignez l'adresse IP_DU_SERVEUR et le port 16261.
  4. Indiquez le mot de passe du serveur s'il y en a un, ainsi que votre nom d'utilisateur et votre mot de passe de compte.

Pour vous connecter en administrateur, utilisez le nom d'utilisateur admin et le mot de passe choisi au premier lancement.

Administration

Envoyer une commande au serveur

Depuis le serveur, écrivez la commande dans le canal, sans / au début. Le résultat apparaît dans les logs :

Terminal
echo 'players' | sudo tee /run/zomboid.control
sudo journalctl -u zomboid.service -n 20

En jeu, tapez les mêmes commandes dans le chat, précédées de /.

Commandes utiles

Commande Description
players Lister les joueurs connectés
save Enregistrer le monde
quit Enregistrer et arrêter le serveur
servermsg "message" Envoyer un message à tous les joueurs
setaccesslevel "pseudo" "admin" Changer le rôle d'un joueur
adduser "pseudo" "motdepasse" Créer un compte
setpassword "pseudo" "motdepasse" Changer le mot de passe d'un compte
kickuser "pseudo" -r "raison" Expulser un joueur
banuser "pseudo" -ip -r "raison" Bannir un joueur et son adresse IP
unbanuser "pseudo" Débannir un joueur
reloadoptions Recharger servertest.ini
showoptions Afficher les réglages actifs
checkModsNeedUpdate Écrire dans les logs si un mod a été mis à jour
help Lister les commandes

Les rôles disponibles sont admin, moderator, overseer, gm et observer.

RCON (optionnel)

Pour utiliser un outil RCON, définissez RCONPassword avec un mot de passe long, puis ouvrez le port 27015 à votre seule adresse IP : remplacez VOTRE_IP.

UFW :

Terminal
sudo ufw allow from VOTRE_IP to any port 27015 proto tcp
sudo ufw reload

iptables :

Terminal
sudo iptables -A INPUT -p tcp -s VOTRE_IP --dport 27015 -j ACCEPT
sudo iptables -A INPUT ! -i lo -p tcp --dport 27015 -j DROP
sudo iptables-save | sudo tee /etc/iptables/rules.v4

nftables :

Terminal
sudo nft add rule inet filter input ip saddr VOTRE_IP tcp dport 27015 accept
sudo nft add rule inet filter input iifname != "lo" tcp dport 27015 drop
(echo "flush ruleset"; sudo nft list ruleset) | sudo tee /etc/nftables.conf

Installer des mods du Workshop

Le serveur télécharge lui-même les mods au démarrage, et le jeu propose aux joueurs de les installer en se connectant. Il faut deux informations par mod, disponibles sur sa page du Workshop :

Information Où la trouver Paramètre
Identifiant Workshop Nombre à la fin de l'adresse de la page (?id=...) WorkshopItems
Identifiant du mod Ligne Mod ID de la description, ou id= dans mod.info Mods

Arrêtez le serveur, puis modifiez servertest.ini :

Terminal
sudo systemctl stop zomboid.service
sudo -u zomboid nano /home/zomboid/Zomboid/Server/servertest.ini

Séparez les valeurs par des points-virgules :

Configuration
WorkshopItems=1111111111;2222222222
Mods=PremierMod;DeuxiemeMod

Un élément du Workshop peut contenir plusieurs mods : ajoutez uniquement ceux que vous voulez activer dans Mods. Certains exports de liste de mods écrivent \PremierMod : le serveur accepte aussi cette forme.

Pour un mod de carte, ajoutez le nom de son dossier de carte (dans media/maps) avant la carte de base :

Configuration
Map=MaCarteMod;Muldraugh, KY

Redémarrez ensuite le serveur et suivez le téléchargement dans les logs :

Terminal
sudo systemctl start zomboid.service
sudo journalctl -u zomboid.service -f

Mise à jour du serveur

Terminal
sudo systemctl stop zomboid.service
sudo -iu zomboid /home/zomboid/update-server.sh
sudo systemctl start zomboid.service

Le serveur et les joueurs doivent avoir la même version. Sauvegardez avant chaque mise à jour importante.

Sauvegarde automatique

Sauvegardes intégrées

Le serveur crée des archives dans /home/zomboid/Zomboid/backups/, réglées dans servertest.ini :

Paramètre Description Valeur par défaut
BackupsCount Nombre d'archives conservées 5
BackupsOnStart Sauvegarde au démarrage true
BackupsOnVersionChange Sauvegarde quand la version du jeu change true
BackupsPeriod Intervalle des sauvegardes périodiques, 0 pour les désactiver 0

Script de sauvegarde

Ce script arrête proprement le serveur, archive le monde, les comptes et la configuration, puis le relance :

Terminal
sudo nano /usr/local/sbin/backup-zomboid.sh
Terminal
#!/bin/bash
set -euo pipefail
umask 027

BACKUP_DIR="/home/zomboid/backups"
DATE=$(date +%Y-%m-%d_%H-%M-%S)
ARCHIVE="$BACKUP_DIR/zomboid_$DATE.tar.gz"

install -d -o zomboid -g zomboid -m 750 "$BACKUP_DIR"

systemctl stop zomboid.service
trap 'systemctl start zomboid.service' EXIT

tar -czf "$ARCHIVE" -C /home/zomboid Zomboid/Server Zomboid/db Zomboid/Saves/Multiplayer
chown zomboid:zomboid "$ARCHIVE"

# Supprimer les sauvegardes de plus de 7 jours
find "$BACKUP_DIR" -name "zomboid_*.tar.gz" -mtime +7 -delete
Terminal
sudo chmod 750 /usr/local/sbin/backup-zomboid.sh
sudo /usr/local/sbin/backup-zomboid.sh
sudo ls -lh /home/zomboid/backups

Planifier la sauvegarde

Terminal
sudo nano /etc/cron.d/zomboid-backup
Texte
# Sauvegarde chaque nuit à 5 h 30
30 5 * * * root /usr/local/sbin/backup-zomboid.sh

Copiez régulièrement ces archives hors du serveur. Elles contiennent les comptes et les mots de passe de configuration : gardez-les privées.

Restaurer une sauvegarde

Terminal
sudo systemctl stop zomboid.service
sudo -u zomboid mv /home/zomboid/Zomboid /home/zomboid/Zomboid.old
sudo -u zomboid mkdir /home/zomboid/Zomboid
sudo -u zomboid tar -xzf /home/zomboid/backups/zomboid_DATE.tar.gz -C /home/zomboid
sudo systemctl start zomboid.service

Remplacez DATE par la date de l'archive.

En cas de problème

Le service reste bloqué au démarrage

Si les logs s'arrêtent sur Enter new administrator password:, le compte admin n'a pas encore été créé. Arrêtez le service et faites le premier lancement à la main :

Terminal
sudo systemctl stop zomboid.service
sudo -iu zomboid /home/zomboid/pz-server/start-server.sh -servername servertest

Only 64bit is supported

Ce message apparaît quand le Java fourni ne peut pas démarrer : installation incomplète ou machine qui n'est pas en x86_64. Vérifiez l'architecture avec uname -m, puis relancez /home/zomboid/update-server.sh avec l'utilisateur zomboid.

Le serveur s'arrête faute de mémoire

Les logs affichent java.lang.OutOfMemoryError, ou le système a tué le processus :

Terminal
sudo journalctl -k | grep -iE 'out of memory|killed process'

Si Java manque de mémoire, augmentez XMX dans /home/zomboid/update-server.sh. Si le système a tué le processus, diminuez cette valeur ou passez à une offre avec plus de RAM. Dans les deux cas, relancez ensuite ce script, serveur arrêté.

Erreur steamclient.so

Si les logs signalent que steamclient.so est introuvable, créez le lien attendu :

Terminal
sudo -iu zomboid
mkdir -p ~/.steam/sdk64
ln -sf ~/pz-server/linux64/steamclient.so ~/.steam/sdk64/steamclient.so
exit

Les joueurs ne peuvent pas se connecter

  • Attendez *** SERVER STARTED **** dans les logs
  • Vérifiez que les ports 16261 et 16262 sont ouverts en UDP
  • Vérifiez que le serveur écoute : sudo ss -ulpn | grep -E ':(16261|16262)\b'

Messages affichés aux joueurs

Message Cause et solution
Client version (...) does not match server version (...) Mettez le serveur et le jeu à la même version, sur la même branche Steam
Wrong server password given Le champ de mot de passe du serveur est incorrect
Wrong username or password given Le compte existe avec un autre mot de passe : changez-le avec setpassword
Workshop item version is different than the server's Un mod a été mis à jour : redémarrez le serveur, puis relancez le jeu
Mod "..." is not installed Le joueur n'a pas le mod, ou Mods contient un identifiant incorrect
The server is full Augmentez MaxPlayers si votre machine le permet

L'arrêt du service est long

C'est normal : le serveur enregistre le monde avant de s'arrêter. Le service lui laisse 3 minutes (TimeoutStopSec=180). Sur un très grand monde, augmentez cette valeur.