Comment installation un serveur Hytale sur VPS Linux

1. Introduction

Qu'est-ce que Hytale ?

Hytale est un jeu de type sandbox développé par Hypixel Studios, sorti en accès anticipé le 13 janvier 2026. Il combine exploration, construction, combat et création de contenu dans un univers procédural riche. Le serveur dédié permet d'héberger des parties multijoueurs persistantes.

Fonctionnalités principales

• Mondes procéduraux avec biomes variés
• Système de mods et personnalisation avancée
• Protocole réseau moderne QUIC over UDP
• Support des architectures x64 et arm64
• Gestion des permissions et des mondes multiples
• Système d'authentification intégré via compte Hytale

Cas d'usage typiques

• Serveur privé entre amis (5-10 joueurs)
• Serveur communautaire public (20-50 joueurs)
• Serveur de mini-jeux personnalisés
• Serveur créatif avec mods

Version documentée

• Hytale Server : v1.0.0 (janvier 2026)
• Java requis : OpenJDK 25 LTS (Temurin)

---

🚀 Vous préférez une solution clé en main ?

Avec OuiHeberg, votre serveur Hytale est préinstallé et prêt à jouer en moins de 60 secondes. Pas de configuration technique, mises à jour automatiques, support 24/7 et protection anti-DDoS incluse.

➡️ Découvrir nos offres Hébergement Hytale

---

2. Prérequis

Configuration matérielle

Ressource	Minimum	Recommandé	Performance
RAM	4 GB	8 GB	16 GB
CPU	2 vCores	4 vCores	6+ vCores
Stockage	10 GB SSD	20 GB SSD	50 GB NVMe
Bande passante	100 Mbps	1 Gbps	1 Gbps
Joueurs supportés	5-10	10-30	50+

💡 Astuce : La vitesse du CPU (fréquence par cœur) est plus importante que le nombre de cœurs pour Hytale.

Logiciels requis

Logiciel	Version	Obligatoire
Debian / Ubuntu	12+ / 22.04+	✅
Java (OpenJDK)	25 LTS	✅
unzip	Dernière	✅
UFW (pare-feu)	Dernière	Recommandé

Ports réseau

Port	Protocole	Usage	Obligatoire
5520	UDP	Serveur Hytale (QUIC)	✅
22	TCP	SSH (administration)	✅

⚠️ Important : Hytale utilise exclusivement UDP via le protocole QUIC. Ne pas ouvrir le port en TCP.

Fichiers serveur requis

Fichier	Taille	Description
HytaleServer.jar	~50 MB	Exécutable du serveur
Assets.zip	~3.2 GB	Ressources du jeu (textures, sons, modèles)

---

3. Installation étape par étape

Étape 1 : Mise à jour du système

sudo apt update && sudo apt upgrade -y

ℹ️ Cette commande met à jour la liste des paquets et installe les dernières versions disponibles.

Étape 2 : Installation de Java 25

Ajoutez le dépôt Adoptium et installez OpenJDK 25 :

# Installation des dépendances
sudo apt install -y wget apt-transport-https gnupg

# Ajout de la clé GPG Adoptium
wget -qO - https://packages.adoptium.net/artifactory/api/gpg/key/public | sudo tee /usr/share/keyrings/adoptium.asc

# Ajout du dépôt
echo "deb [signed-by=/usr/share/keyrings/adoptium.asc] https://packages.adoptium.net/artifactory/deb $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/adoptium.list

# Installation de Java 25
sudo apt update
sudo apt install -y temurin-25-jdk

Point de vérification :

java --version

Résultat attendu :

openjdk 25.0.1 2025-10-21 LTS
OpenJDK Runtime Environment Temurin-25.0.1+8 (build 25.0.1+8-LTS)
OpenJDK 64-Bit Server VM Temurin-25.0.1+8 (build 25.0.1+8-LTS, mixed mode, sharing)

Étape 3 : Création d'un utilisateur dédié

Pour des raisons de sécurité, créez un utilisateur système sans privilèges root :

sudo adduser --system --group --home /opt/hytale --shell /bin/bash hytale

💡 Bonne pratique : Ne jamais exécuter un serveur de jeu en tant que root.

Étape 4 : Préparation de l'arborescence

# Création des dossiers
sudo mkdir -p /opt/hytale/server
sudo mkdir -p /opt/hytale/backups

# Attribution des permissions
sudo chown -R hytale:hytale /opt/hytale

Étape 5 : Téléchargement des fichiers serveur

Utilisez l'outil officiel hytale-downloader pour télécharger les fichiers serveur directement sur votre VPS :

# Connexion en tant qu'utilisateur hytale
sudo su - hytale
cd /opt/hytale/server

# Téléchargement de l'outil
wget -q https://downloader.hytale.com/hytale-downloader.zip

# Extraction
unzip hytale-downloader.zip

# Attribution des permissions d'exécution
chmod +x bin/hytale-downloader

# Téléchargement des fichiers serveur (HytaleServer.jar + Assets.zip)
./bin/hytale-downloader --server

ℹ️ L'outil vous demandera de vous authentifier avec votre compte Hytale lors du premier téléchargement.

Point de vérification :

ls -lh /opt/hytale/server/

Résultat attendu :

-rw-r--r-- 1 hytale hytale  50M jan 15 10:00 HytaleServer.jar
-rw-r--r-- 1 hytale hytale 3.2G jan 15 10:05 Assets.zip
drwxr-xr-x 2 hytale hytale 4.0K jan 15 10:00 bin/

Étape 6 : Configuration du pare-feu

# Activation de UFW si nécessaire
sudo ufw enable

# Ouverture du port SSH (si pas déjà fait)
sudo ufw allow 22/tcp

# Ouverture du port Hytale (UDP uniquement)
sudo ufw allow 5520/udp

# Rechargement des règles
sudo ufw reload

# Vérification
sudo ufw status verbose

Résultat attendu :

5520/udp                   ALLOW IN    Anywhere

---

4. Configuration

Script de démarrage

Créez le fichier /opt/hytale/server/start.sh :

sudo -u hytale nano /opt/hytale/server/start.sh

Contenu du script :

#!/bin/bash
#
# Script de démarrage Hytale Server
# OuiHeberg - Guide d'installation
#

cd /opt/hytale/server

# Configuration JVM
JAVA_OPTS="-Xms4G -Xmx6G"
JAVA_OPTS="$JAVA_OPTS -XX:+UseG1GC"
JAVA_OPTS="$JAVA_OPTS -XX:MaxGCPauseMillis=200"
JAVA_OPTS="$JAVA_OPTS -XX:+ParallelRefProcEnabled"
JAVA_OPTS="$JAVA_OPTS -XX:+UnlockExperimentalVMOptions"
JAVA_OPTS="$JAVA_OPTS -XX:+DisableExplicitGC"

# Démarrage du serveur
java $JAVA_OPTS -jar HytaleServer.jar \
    --assets Assets.zip \
    --bind 0.0.0.0:5520

Rendez le script exécutable :

sudo chmod +x /opt/hytale/server/start.sh
sudo chown hytale:hytale /opt/hytale/server/start.sh

Optimisation JVM selon le nombre de joueurs

Joueurs	RAM VPS	Paramètres JVM
5-10	6 GB	-Xms3G -Xmx5G -XX:+UseG1GC
10-20	8 GB	-Xms4G -Xmx6G -XX:+UseG1GC -XX:MaxGCPauseMillis=200
20-40	16 GB	-Xms8G -Xmx12G -XX:+UseG1GC -XX:MaxGCPauseMillis=200
50+	32 GB	-Xms16G -Xmx24G -XX:+UseZGC

⚠️ Important : Laissez toujours 1-2 GB de RAM disponible pour le système d'exploitation.

Configuration du serveur (config.json)

Après le premier démarrage, éditez /opt/hytale/server/config.json :

{
  "Version": 3,
  "ServerName": "Mon Serveur Hytale",
  "MOTD": "Bienvenue sur notre serveur !",
  "Password": "",
  "MaxPlayers": 20,
  "MaxViewRadius": 16,
  "LocalCompressionEnabled": false,
  "Defaults": {
    "World": "default",
    "GameMode": "Adventure"
  },
  "ConnectionTimeouts": {
    "JoinTimeouts": {}
  },
  "RateLimit": {},
  "Modules": {},
  "LogLevels": {},
  "Mods": {},
  "DisplayTmpTagsInStrings": false,
  "PlayerStorage": {
    "Type": "Hytale"
  }
}

Paramètres importants :

Paramètre	Valeur recommandée	Description
ServerName	Votre nom	Nom affiché dans la liste des serveurs
MaxPlayers	20	Nombre maximum de joueurs simultanés
MaxViewRadius	16	Distance de rendu (32 = élevé, consomme beaucoup)
Password	""	Vide = serveur public, sinon mot de passe requis
GameMode	Adventure	Mode par défaut : Adventure, Creative, Survival

💡 Optimisation : Réduire MaxViewRadius de 32 à 16 diminue significativement la consommation RAM et CPU.

Service systemd (démarrage automatique)

Créez le fichier /etc/systemd/system/hytale.service :

sudo nano /etc/systemd/system/hytale.service

Contenu :

[Unit]
Description=Hytale Dedicated Server
Documentation=https://support.hytale.com
After=network.target

[Service]
Type=simple
User=hytale
Group=hytale
WorkingDirectory=/opt/hytale/server
ExecStart=/opt/hytale/server/start.sh
ExecStop=/bin/kill -SIGINT $MAINPID
Restart=on-failure
RestartSec=10
StandardOutput=journal
StandardError=journal
SyslogIdentifier=hytale

# Sécurité
NoNewPrivileges=true
PrivateTmp=true

[Install]
WantedBy=multi-user.target

Activez et démarrez le service :

sudo systemctl daemon-reload
sudo systemctl enable hytale
sudo systemctl start hytale

---

5. Première utilisation

Premier démarrage

sudo systemctl start hytale

Surveillez les logs en temps réel :

sudo journalctl -u hytale -f

Sortie attendue :

[INFO] Starting Hytale Server v1.0.0
[INFO] Loading Assets.zip... (1-2 minutes)
[INFO] World generation complete
[WARN] Server requires authentication
[INFO] Use command: /auth login device
[INFO] Server online on port 5520

Authentification du serveur

Accédez à la console du serveur :

sudo -u hytale screen -S hytale

Ou via systemd :

sudo systemctl stop hytale
sudo -u hytale /opt/hytale/server/start.sh

Dans la console, tapez :

/auth login device

Un code apparaît :

===================================================================
DEVICE AUTHORIZATION
===================================================================
Visit: https://accounts.hytale.com/device
Enter code: ABCD-1234
===================================================================

1. Rendez-vous sur https://accounts.hytale.com/device
2. Entrez le code affiché (ex: ABCD-1234)
3. Validez avec votre compte Hytale

⚠️ Important : Le code expire après 15 minutes. L'authentification est obligatoire pour que les joueurs puissent se connecter.

Connexion des joueurs

Les joueurs peuvent se connecter via :

• IP directe : votre-ip-publique:5520
• Domaine : play.votredomaine.fr:5520

---

6. Maintenance

Commandes de gestion du service

Action	Commande
Démarrer	sudo systemctl start hytale
Arrêter	sudo systemctl stop hytale
Redémarrer	sudo systemctl restart hytale
Statut	sudo systemctl status hytale
Logs temps réel	sudo journalctl -u hytale -f
Logs complets	sudo journalctl -u hytale --no-pager

Mise à jour du serveur

# Arrêt du serveur
sudo systemctl stop hytale

# Sauvegarde avant mise à jour
sudo -u hytale cp -r /opt/hytale/server /opt/hytale/backups/server-$(date +%Y%m%d)

# Téléchargement des nouveaux fichiers
sudo su - hytale
cd /opt/hytale/server
./bin/hytale-downloader --server --update

# Redémarrage
exit
sudo systemctl start hytale

Sauvegarde automatique

Créez un script de sauvegarde /opt/hytale/backup.sh :

#!/bin/bash
#
# Script de sauvegarde Hytale
#

BACKUP_DIR="/opt/hytale/backups"
SERVER_DIR="/opt/hytale/server"
DATE=$(date +%Y%m%d-%H%M%S)
RETENTION_DAYS=7

# Création de la sauvegarde
tar -czf "$BACKUP_DIR/hytale-$DATE.tar.gz" \
    -C "$SERVER_DIR" \
    config.json \
    universe/ \
    mods/ \
    --exclude='*.log'

# Suppression des anciennes sauvegardes
find "$BACKUP_DIR" -name "hytale-*.tar.gz" -mtime +$RETENTION_DAYS -delete

echo "Sauvegarde terminée : hytale-$DATE.tar.gz"

Rendez-le exécutable et planifiez-le :

sudo chmod +x /opt/hytale/backup.sh
sudo chown hytale:hytale /opt/hytale/backup.sh

# Ajout au cron (sauvegarde quotidienne à 4h)
echo "0 4 * * * hytale /opt/hytale/backup.sh" | sudo tee /etc/cron.d/hytale-backup

Restauration

# Arrêt du serveur
sudo systemctl stop hytale

# Restauration depuis une sauvegarde
cd /opt/hytale/server
sudo -u hytale tar -xzf /opt/hytale/backups/hytale-YYYYMMDD-HHMMSS.tar.gz

# Redémarrage
sudo systemctl start hytale

Monitoring

Surveillez les ressources du serveur :

# Utilisation mémoire du processus Java
ps aux | grep HytaleServer

# Utilisation CPU et RAM en temps réel
htop -p $(pgrep -f HytaleServer)

# Espace disque
df -h /opt/hytale

---

7. Dépannage

Problèmes courants

Problème	Cause	Solution
Java version incorrecte	Java < 25	Installer Java 25 via Adoptium
Assets.zip not found	Fichier manquant	Placer Assets.zip dans /opt/hytale/server/
Port 5520 already in use	Autre instance active	sudo lsof -i :5520 puis kill PID
OutOfMemoryError	RAM insuffisante	Augmenter -Xmx ou réduire MaxViewRadius
Joueurs ne peuvent pas se connecter	Pare-feu / authentification	Vérifier UFW + /auth login device

Commandes de diagnostic

# Vérifier si le serveur écoute
sudo ss -ulnp | grep 5520

# Vérifier les logs d'erreur
sudo journalctl -u hytale --since "1 hour ago" | grep -i error

# Tester la connectivité UDP (depuis un autre serveur)
nc -vzu votre-ip 5520

# Vérifier la version Java
java --version

# Vérifier les permissions
ls -la /opt/hytale/server/

Erreurs fréquentes dans les logs

Erreur : GC overhead limit exceeded

# Augmentez la RAM allouée
-Xmx8G au lieu de -Xmx6G

Erreur : Unable to bind to address

# Vérifiez qu'aucun autre processus n'utilise le port
sudo fuser -k 5520/udp

Erreur : Authentication required

# Relancez l'authentification
/auth login device

---

8. Ressources

Documentation officielle

Ressource	URL
Manuel serveur officiel	https://support.hytale.com/hc/en-us/articles/45326769420827-Hytale-Server-Manual
Site officiel Hytale	https://hytale.com
Authentification	https://accounts.hytale.com/device
Adoptium (Java 25)	https://adoptium.net

Communauté

Plateforme	Lien
Discord officiel	https://discord.gg/hytale
Reddit	https://reddit.com/r/hytale
Forums officiels	https://forums.hytale.com

---

💡 L'installation vous semble complexe ?

Gagnez du temps avec un serveur Hytale préinstallé chez OuiHeberg :

• ✅ Serveur prêt en 60 secondes
• ✅ Panel de gestion simplifié
• ✅ Mises à jour en 1 clic
• ✅ Sauvegardes automatiques
• ✅ Support technique 24/7
• ✅ Protection anti-DDoS incluse

➡️ Commander votre serveur Hytale

---

Récapitulatif des commandes

# === INSTALLATION COMPLÈTE ===

# 1. Mise à jour système
sudo apt update && sudo apt upgrade -y

# 2. Installation Java 25
sudo apt install -y wget apt-transport-https gnupg unzip
wget -qO - https://packages.adoptium.net/artifactory/api/gpg/key/public | sudo tee /usr/share/keyrings/adoptium.asc
echo "deb [signed-by=/usr/share/keyrings/adoptium.asc] https://packages.adoptium.net/artifactory/deb $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/adoptium.list
sudo apt update && sudo apt install -y temurin-25-jdk

# 3. Création utilisateur
sudo adduser --system --group --home /opt/hytale --shell /bin/bash hytale

# 4. Préparation dossiers
sudo mkdir -p /opt/hytale/{server,backups}
sudo chown -R hytale:hytale /opt/hytale

# 5. Pare-feu
sudo ufw allow 5520/udp
sudo ufw reload

# 6. Téléchargement des fichiers serveur
sudo su - hytale
cd /opt/hytale/server
wget -q https://downloader.hytale.com/hytale-downloader.zip
unzip hytale-downloader.zip
chmod +x bin/hytale-downloader
./bin/hytale-downloader --server
exit

# 7. Créer start.sh et hytale.service (voir sections ci-dessus)

# 8. Démarrage
sudo systemctl daemon-reload
sudo systemctl enable hytale
sudo systemctl start hytale

# 9. Authentification
# Dans la console : /auth login device
# Puis valider sur https://accounts.hytale.com/device

---

Guide rédigé par OuiHeberg — Dernière mise à jour : 15 janvier 2026