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.
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 :
- VPS Performance - Ressources dédiées et processeurs rapides, idéal pour Project Zomboid
- VPS NVMe - Pour un petit serveur entre amis
- Serveurs dédiés Eco - Pour les serveurs avec beaucoup de joueurs ou de mods
- Serveurs dédiés Performance - Performance maximale
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
sudo apt update && sudo apt upgrade -yInstallation des dépendances
Java est fourni avec le serveur, inutile de l'installer. lib32gcc-s1 est nécessaire à SteamCMD :
sudo apt install -y curl tar ca-certificates lib32gcc-s1 libstdc++6Création d'un utilisateur dédié
Le serveur ne doit jamais tourner en root. Créez un utilisateur dédié :
sudo adduser --disabled-password --gecos "" zomboidPorts 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
sudo ufw allow 16261/udp
sudo ufw allow 16262/udp
sudo ufw reloadAvec iptables
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.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 16261 accept
sudo nft add rule inet filter input udp dport 16262 accept
(echo "flush ruleset"; sudo nft list ruleset) | sudo tee /etc/nftables.confInstallation de SteamCMD
Connectez-vous en tant qu'utilisateur zomboid et préparez les dossiers :
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 :
nano ~/update-server.sh#!/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.jsonchmod +x ~/update-server.sh
~/update-server.shSi 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 :
~/pz-server/start-server.sh -servername servertestChoisissez le mot de passe administrateur lorsque ces messages apparaissent :
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 :
quitQuittez ensuite la session de l'utilisateur zomboid :
exitConfiguration 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 :
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 :
PublicName=Mon serveur Project Zomboid
Password=ChangezCeMotDePasse
MaxPlayers=16
UPnP=falseConfiguration 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
sudo nano /etc/systemd/system/zomboid.socket[Unit]
BindsTo=zomboid.service
[Socket]
ListenFIFO=/run/zomboid.control
FileDescriptorName=control
RemoveOnStop=true
SocketMode=0660
SocketUser=zomboid
SocketGroup=zomboidCréer le fichier de service
sudo nano /etc/systemd/system/zomboid.service[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.targetActiver et démarrer le service
sudo systemctl daemon-reload
sudo systemctl enable zomboid.service
sudo systemctl start zomboid.serviceCommandes de gestion
# 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 -fVérifier le serveur
Attendez le message de démarrage, qui peut prendre plusieurs minutes :
sudo journalctl -u zomboid.service | grep 'SERVER STARTED'Vérifiez ensuite que les ports écoutent :
sudo ss -ulpn | grep -E ':(16261|16262)\b'Connexion au serveur
- Lancez Project Zomboid, dans la même version que le serveur.
- Ouvrez Join dans le menu principal.
- Renseignez l'adresse
IP_DU_SERVEURet le port16261. - 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 :
echo 'players' | sudo tee /run/zomboid.control
sudo journalctl -u zomboid.service -n 20En 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 :
sudo ufw allow from VOTRE_IP to any port 27015 proto tcp
sudo ufw reloadiptables :
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.v4nftables :
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.confInstaller 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 :
sudo systemctl stop zomboid.service
sudo -u zomboid nano /home/zomboid/Zomboid/Server/servertest.iniSéparez les valeurs par des points-virgules :
WorkshopItems=1111111111;2222222222
Mods=PremierMod;DeuxiemeModUn é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 :
Map=MaCarteMod;Muldraugh, KYRedémarrez ensuite le serveur et suivez le téléchargement dans les logs :
sudo systemctl start zomboid.service
sudo journalctl -u zomboid.service -fMise à jour du serveur
sudo systemctl stop zomboid.service
sudo -iu zomboid /home/zomboid/update-server.sh
sudo systemctl start zomboid.serviceLe 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 :
sudo nano /usr/local/sbin/backup-zomboid.sh#!/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 -deletesudo chmod 750 /usr/local/sbin/backup-zomboid.sh
sudo /usr/local/sbin/backup-zomboid.sh
sudo ls -lh /home/zomboid/backupsPlanifier la sauvegarde
sudo nano /etc/cron.d/zomboid-backup# Sauvegarde chaque nuit à 5 h 30
30 5 * * * root /usr/local/sbin/backup-zomboid.shCopiez 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
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.serviceRemplacez 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 :
sudo systemctl stop zomboid.service
sudo -iu zomboid /home/zomboid/pz-server/start-server.sh -servername servertestOnly 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 :
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 :
sudo -iu zomboid
mkdir -p ~/.steam/sdk64
ln -sf ~/pz-server/linux64/steamclient.so ~/.steam/sdk64/steamclient.so
exitLes 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.