Installer un serveur Terraria

Installation pas à pas

1. 1

   Vérifiez la configuration requise (CPU, RAM, disque) et choisissez l'hôte : PC Windows, VPS ou serveur dédié.

2. 2

   Téléchargez le serveur dédié depuis terraria.org (lien « Dedicated Server » en bas de page) et décompressez-le.

3. 3

   Sous Linux, créez un utilisateur non-root et un dossier dédié ; sous Windows, un dossier simple (ex. C:\serveur).

4. 4

   Lancez le serveur une première fois pour générer ses fichiers de configuration, puis arrêtez-le proprement.

5. 5

   Configurez nom, mot de passe et nombre de slots (voir nos outils Terraria pour générer les fichiers).

6. 6

   Ouvrez les ports 7777/TCP dans le pare-feu du système et du fournisseur ; redirigez-les sur votre box si vous hébergez chez vous.

7. 7

   Testez en local (127.0.0.1), puis depuis une connexion extérieure à votre réseau.

8. 8

   Créez un service systemd (Linux) ou une tâche planifiée (Windows) pour le démarrage automatique.

9. 9

   Planifiez les sauvegardes et les mises à jour du serveur.

10. 10

    Ajoutez votre serveur sur game-rank.com/jeux/terraria pour le faire connaître.

Prérequis

• Système : Linux ou Windows.
• Matériel : non documenté officiellement dans les sources consultées ; point de départ à ajuster selon la charge : RAM 1 / 2 GB, disque 1 GB.
• Compte : aucun compte Steam n'est nécessaire pour le serveur téléchargé sur terraria.org ; les joueurs doivent posséder le jeu et avoir la même version.
• Réseau : une IP publique (ou une redirection de ports) avec les ports 7777/TCP ouverts.
• Accès : SSH (Linux) ou Bureau à distance (Windows Server) ; un SSD est recommandé.

Installation locale (Windows)

Téléchargez et décompressez le serveur depuis terraria.org, puis lancez TerrariaServer.exe depuis le dossier Windows. Vous pouvez aussi utiliser notre générateur de serverconfig.txt. Connectez-vous ensuite avec le jeu sur 127.0.0.1.

cd C:\terraria-server\<version>\Windows
TerrariaServer.exe -config serverconfig.txt

Installation sur VPS ou serveur dédié Linux (Ubuntu/Debian)

Créez un utilisateur dédié sans droits root, installez unzip et tmux, téléchargez le serveur depuis terraria.org (copiez l'adresse du lien « Dedicated Server »), décompressez-le et rendez les fichiers exécutables.

sudo apt update && sudo apt install -y unzip tmux wget
sudo adduser --disabled-password --gecos "" terraria
# then, as the terraria user (sudo -iu terraria):
mkdir -p ~/server && cd ~/server
wget -O terraria-server.zip "<address of the Dedicated Server link on terraria.org>"
unzip terraria-server.zip
ln -s ~/server/*/Linux ~/server/Linux
cd ~/server/Linux && chmod u+x TerrariaServer*
./TerrariaServer -config serverconfig.txt

Ports à ouvrir

Valeurs par défaut ; le sens du trafic est entrant (vers le serveur).

Pour changer un port, modifiez-le dans la configuration ou la ligne de lancement du serveur (serverconfig.txt: port) puis adaptez le pare-feu.

• 7777/TCP — jeu

Pare-feu Linux (ufw), fournisseur et box

Autorisez d'abord SSH pour ne pas vous bloquer, puis les ports du jeu. Les ports ne sont ouverts que s'ils le sont aussi dans le pare-feu du fournisseur (OVH, Hetzner, Scaleway… : « security group » ou règles réseau du panel).

Hébergement à la maison : créez une redirection de ports (NAT) sur la box vers l'IP locale fixe du serveur, pour les mêmes ports et protocoles. Si votre opérateur utilise le CGNAT (pas d'IPv4 publique), la redirection est impossible : demandez une IP publique ou louez un VPS.

Test : UDP ne se teste pas avec un simple testeur de port web ; vérifiez en vous connectant au jeu depuis un réseau extérieur (partage de connexion mobile, par exemple) et consultez les journaux du serveur.

sudo ufw allow 22/tcp
sudo ufw allow 7777/tcp
sudo ufw enable
sudo ufw status verbose

Pare-feu Windows (netsh)

Exécutez ces commandes dans une invite de commandes lancée en administrateur. Pour un hébergement à la maison, ajoutez aussi la redirection de ports sur la box.

netsh advfirewall firewall add rule name="Terraria 7777 TCP" dir=in action=allow protocol=TCP localport=7777

Démarrage automatique sous Linux (systemd)

Le service redémarre le serveur après un plantage et au démarrage de la machine. Activez-le avec les commandes indiquées dans le bloc.

[Unit]
Description=Terraria dedicated server
After=network-online.target
Wants=network-online.target

[Service]
Type=forking
RemainAfterExit=yes
User=terraria
WorkingDirectory=/home/terraria/server/Linux
ExecStart=/usr/bin/tmux new-session -d -s terraria '/home/terraria/server/Linux/TerrariaServer -config serverconfig.txt'
ExecStop=/usr/bin/tmux send-keys -t terraria 'exit' Enter
TimeoutStopSec=60

[Install]
WantedBy=multi-user.target

# sudo nano /etc/systemd/system/terraria.service
# sudo systemctl daemon-reload && sudo systemctl enable --now terraria
# console: sudo -u terraria tmux attach -t terraria

Démarrage automatique sous Windows (tâche planifiée)

Créez une tâche qui lance le script de démarrage au démarrage de Windows, sous un compte dédié si possible. Adaptez le chemin du script.

schtasks /Create /TN "Terraria Server" /TR "C:\terraria-server\<version>\Windows\start-terraria.bat" /SC ONSTART /RU SYSTEM /RL HIGHEST
schtasks /Run /TN "Terraria Server"
schtasks /End /TN "Terraria Server"

Mises à jour, sauvegardes et redémarrages

Terraria n'a pas de mise à jour automatique : téléchargez la nouvelle archive du serveur sur terraria.org à chaque version du jeu (les joueurs et le serveur doivent avoir la même version), puis conservez serverconfig.txt et les mondes.

sudo systemctl stop terraria
# download the new archive from terraria.org, unzip it, keep serverconfig.txt
mkdir -p ~/backups
tar czf ~/backups/terraria-$(date +%F).tar.gz -C ~/.local/share/Terraria Worlds
find ~/backups -name 'terraria-*.tar.gz' -mtime +14 -delete
sudo systemctl start terraria
# Windows worlds: %USERPROFILE%\Documents\My Games\Terraria\Worlds

Déclarer et trouver votre serveur

Une fois le serveur stable, ajoutez-le sur game-rank.com/jeux/terraria (site du propriétaire de ces outils) avec son adresse de connexion, ses slots, sa langue et sa version. Adresse de connexion directe à partager : <IP>:7777 (selon la version du jeu). Ne publiez jamais de mot de passe d'administration.

Dépannage

• Le serveur n'apparaît pas dans la liste — cause : ports de requête fermés ou serveur non listé. Solution : ouvrez 7777/TCP, vérifiez le nom/mot de passe et patientez quelques minutes ; connectez-vous en direct par IP pour tester.
• Connexion impossible depuis Internet mais OK en local — cause : pare-feu du système/fournisseur, redirection de ports absente ou CGNAT. Solution : vérifiez les trois niveaux (ufw/Windows, fournisseur, box) et le protocole (UDP/TCP).
• Le serveur s'arrête au démarrage ou manque de mémoire — cause : RAM insuffisante, bibliothèques manquantes ou mauvais dossier de travail. Solution : lancez-le au premier plan, lisez les journaux, ajoutez de la RAM ou du swap.
• Les joueurs voient une version incompatible après une mise à jour du jeu — cause : serveur pas à jour. Solution : arrêtez-le, mettez-le à jour (voir la section Mises à jour) puis redémarrez.
• Les modifications de configuration sont ignorées ou écrasées — cause : fichier modifié pendant que le serveur tourne, mauvais dossier ou erreur de syntaxe. Solution : arrêtez le serveur, éditez le bon fichier, validez la syntaxe (JSON/XML) et redémarrez.

Questions fréquentes

Quelle machine faut-il pour un serveur Terraria ?

Matériel : non documenté officiellement dans les sources consultées ; point de départ à ajuster selon la charge : RAM 1 / 2 GB, disque 1 GB.

Quels ports ouvrir ?

Ouvrez 7777/TCP en entrée, dans le pare-feu du système, chez le fournisseur et sur la box si besoin. Ces valeurs sont celles par défaut et se changent dans la configuration du serveur.

Faut-il posséder le jeu pour héberger ?

Le serveur se télécharge gratuitement sur terraria.org ; les joueurs doivent posséder le jeu.

Comment mettre à jour le serveur ?

Terraria n'a pas de mise à jour automatique : téléchargez la nouvelle archive du serveur sur terraria.org à chaque version du jeu (les joueurs et le serveur doivent avoir la même version), puis conservez serverconfig.txt et les mondes.

Puis-je héberger chez moi ?

Oui, si votre connexion a une IP publique et que vous pouvez rediriger les ports sur la box. Avec le CGNAT ou une connexion faible en envoi, préférez un VPS ou un serveur dédié.