Comment installer un serveur Hytale sur VPS Linux

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 et immersif. Le serveur dédié permet d'héberger des parties multijoueurs persistantes avec une configuration avancée.

Fonctionnalités principales

• Mondes procéduraux avec biomes variés et génération dynamique
• Système de mods et personnalisation avancée du gameplay
• Protocole réseau moderne QUIC over UDP pour des performances optimales
• Support multi-architecture : x64 et arm64
• Gestion avancée des permissions et des mondes multiples
• Authentification intégrée via compte Hytale officiel

Cas d'usage typiques

Version documentée

• Hytale Server : v1.0.0 (janvier 2026)
• Java requis : OpenJDK 25 LTS (Temurin)
• OS supportés : Ubuntu 22.04+, Debian 12+

Prérequis

Configuration matérielle recommandée

💡 Note VeryCloud : La vitesse du CPU (fréquence par cœur) est plus importante que le nombre de cœurs pour Hytale. Nos VPS Ryzen offrent des performances exceptionnelles grâce à leur architecture haute fréquence.

Logiciels requis

Ports réseau

⚠️ IMPORTANT : Hytale utilise exclusivement UDP via le protocole QUIC. Ne configurez PAS le port en TCP. Notre protection Anti-DDoS Netrix est optimisée pour le protocole UDP.

Fichiers serveur requis

Installation étape par étape

Étape 1 : Connexion au VPS VeryCloud

Connectez-vous à votre VPS via SSH depuis votre terminal :

ssh root@votre-ip-vps

💡 Astuce VeryCloud : Vous pouvez trouver votre IP dans l'espace client > Mes Services > Détails du VPS

Étape 2 : Mise à jour du système

sudo apt update && sudo apt upgrade -y

Résultat attendu :

Reading package lists... Done
Building dependency tree... Done
0 upgraded, 0 newly installed, 0 to remove and 0 not upgraded.

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

Étape 3 : Installation de Java 25 LTS

Hytale nécessite impérativement Java 25. Nous utilisons la distribution Temurin d'Adoptium :

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

# 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 Adoptium
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

# Mise à jour et 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 4 : 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

Résultat attendu :

Adding system user `hytale' (UID XXX) ...
Adding new group `hytale' (GID XXX) ...
Adding new user `hytale' (UID XXX) with group `hytale' ...
Creating home directory `/opt/hytale' ...

💡 Bonne pratique : Ne jamais exécuter un serveur de jeu avec des privilèges root. Cela limite les risques en cas de compromission du serveur.

Étape 5 : Préparation de l'arborescence

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

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

# Vérification
ls -la /opt/hytale/

Résultat attendu :

drwxr-xr-x 5 hytale hytale 4096 jan 29 10:00 .
drwxr-xr-x 3 root   root   4096 jan 29 10:00 ..
drwxr-xr-x 2 hytale hytale 4096 jan 29 10:00 backups
drwxr-xr-x 2 hytale hytale 4096 jan 29 10:00 logs
drwxr-xr-x 2 hytale hytale 4096 jan 29 10:00 server

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

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

# Connexion en tant qu'utilisateur hytale
sudo su - hytale

# Navigation vers le dossier serveur
cd /opt/hytale/server

# Téléchargement de l'outil officiel
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
./bin/hytale-downloader --server

ℹ️ Authentification : L'outil vous demandera de vous authentifier avec votre compte Hytale lors du premier téléchargement. Suivez les instructions à l'écran.

Point de vérification :

ls -lh /opt/hytale/server/

Résultat attendu :

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

Retournez à l'utilisateur root :

exit

Étape 7 : Configuration du pare-feu UFW

VeryCloud inclut une protection Anti-DDoS Netrix, mais vous devez configurer votre pare-feu local :

# Installation de UFW si nécessaire
sudo apt install -y ufw

# Autoriser SSH (IMPORTANT : faites ceci AVANT d'activer UFW)
sudo ufw allow 22/tcp

# Autoriser le port Hytale (UDP uniquement)
sudo ufw allow 5520/udp

# Activation du pare-feu
sudo ufw enable

# Vérification
sudo ufw status verbose

Résultat attendu :

Status: active

To                         Action      From
--                         ------      ----
22/tcp                     ALLOW IN    Anywhere
5520/udp                   ALLOW IN    Anywhere

⚠️ CRITIQUE : N'oubliez pas d'autoriser le port SSH (22) AVANT d'activer UFW, sinon vous perdrez l'accès à votre VPS !

Configuration du serveur

Création du script de démarrage

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

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

Copiez-collez le contenu suivant :

#!/bin/bash
#
# Script de démarrage Hytale Server
# VeryCloud - Configuration optimisée
#

cd /opt/hytale/server

# Configuration JVM optimisée pour VeryCloud VPS
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"
JAVA_OPTS="$JAVA_OPTS -XX:G1HeapRegionSize=8M"

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

Enregistrez avec Ctrl+O, Entrée, puis Ctrl+X.

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 votre VPS VeryCloud

⚠️ IMPORTANT : Laissez toujours 1-2 GB de RAM disponible pour le système d'exploitation et les autres processus.

Configuration du serveur (config.json)

Effectuez un premier démarrage pour générer le fichier de configuration :

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

Attendez l'apparition du message d'authentification, puis arrêtez avec Ctrl+C.

Éditez maintenant /opt/hytale/server/config.json :

sudo -u hytale nano /opt/hytale/server/config.json

Configuration recommandée pour VeryCloud :

{
  "Version": 3,
  "ServerName": "Mon Serveur Hytale VeryCloud",
  "MOTD": "Hébergé sur VeryCloud - Infrastructure FR Tier 3+",
  "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 :

💡 Optimisation VeryCloud : Réduire MaxViewRadius de 32 à 16 diminue de 60% la consommation RAM et CPU tout en conservant une expérience de jeu fluide.

Service systemd (démarrage automatique)

Créez le service systemd pour gérer automatiquement votre serveur :

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

Contenu du service :

[Unit]
Description=Hytale Dedicated Server - VeryCloud
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é renforcée
NoNewPrivileges=true
PrivateTmp=true
ProtectSystem=strict
ProtectHome=true
ReadWritePaths=/opt/hytale

[Install]
WantedBy=multi-user.target

Activez et démarrez le service :

# Rechargement des services systemd
sudo systemctl daemon-reload

# Activation au démarrage
sudo systemctl enable hytale

# Démarrage du serveur
sudo systemctl start hytale

# Vérification du statut
sudo systemctl status hytale

Authentification du serveur

Première connexion et authentification

Consultez les logs du serveur :

sudo journalctl -u hytale -f

Vous verrez apparaître un message d'authentification :

[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

Pour accéder à la console du serveur et effectuer l'authentification :

Méthode 1 : Via systemctl (recommandé)

# Arrêt temporaire du service
sudo systemctl stop hytale

# Lancement manuel pour accéder à la console
sudo -u hytale /opt/hytale/server/start.sh

Une fois le serveur démarré, tapez dans la console :

/auth login device

Un code d'authentification apparaît :

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

Processus d'authentification :

1. Ouvrez https://accounts.hytale.com/device dans votre navigateur
2. Entrez le code affiché (ex: ABCD-1234)
3. Connectez-vous avec votre compte Hytale
4. Validez l'autorisation

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

Une fois authentifié, arrêtez le serveur avec Ctrl+C et relancez-le via systemd :

sudo systemctl start hytale

Connexion des joueurs

Les joueurs peuvent maintenant se connecter à votre serveur via :

Option 1 : IP directe

votre-ip-publique:5520

Option 2 : Nom de domaine (si configuré)

play.votredomaine.fr:5520

💡 Astuce VeryCloud : Vous pouvez commander un nom de domaine directement depuis votre espace client VeryCloud et le pointer vers votre VPS.

Gestion et maintenance

Commandes de gestion du service

Mise à jour du serveur

# 1. Arrêt du serveur
sudo systemctl stop hytale

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

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

# 4. Redémarrage
sudo systemctl start hytale

# 5. Vérification
sudo systemctl status hytale

Sauvegarde automatique

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

sudo nano /opt/hytale/backup.sh

Contenu du script :

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

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' \
    --exclude='*.log.gz'

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

# Log du résultat
echo "[$(date)] Sauvegarde terminée : hytale-$DATE.tar.gz" >> /opt/hytale/logs/backup.log

Rendez-le exécutable et planifiez-le :

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

# Planification quotidienne à 4h du matin
echo "0 4 * * * hytale /opt/hytale/backup.sh" | \
  sudo tee /etc/cron.d/hytale-backup

Restauration d'une sauvegarde

# 1. Arrêt du serveur
sudo systemctl stop hytale

# 2. Liste des sauvegardes disponibles
ls -lh /opt/hytale/backups/

# 3. Restauration (remplacez YYYYMMDD-HHMMSS par votre sauvegarde)
cd /opt/hytale/server
sudo -u hytale tar -xzf /opt/hytale/backups/hytale-YYYYMMDD-HHMMSS.tar.gz

# 4. Redémarrage
sudo systemctl start hytale

Monitoring des performances

Surveillance en temps réel

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

# Utilisation CPU et RAM détaillée
htop -p $(pgrep -f HytaleServer)

# Espace disque
df -h /opt/hytale

# Connexions réseau actives
sudo ss -ulnp | grep 5520

Logs de performance

Consultez les métriques dans les logs :

sudo journalctl -u hytale --since "1 hour ago" | grep -i "performance\|tps\|tick"

Dépannage

Problèmes courants

Commandes de diagnostic

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

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

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

# Vérifier la version Java
java --version

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

# Vérifier l'utilisation RAM
free -h

# Vérifier l'espace disque
df -h

# Vérifier le statut du service
sudo systemctl status hytale

Erreurs fréquentes dans les logs

Erreur : GC overhead limit exceeded

Cause : Pas assez de mémoire allouée

Solution :

# Augmentez la RAM dans start.sh
-Xmx8G au lieu de -Xmx6G

Erreur : Unable to bind to address 0.0.0.0:5520

Cause : Port déjà utilisé par un autre processus

Solution :

# Identifiez le processus
sudo lsof -i :5520

# Tuez le processus
sudo kill -9 PID

# Ou libérez le port
sudo fuser -k 5520/udp

Erreur : Authentication required

Cause : Serveur non authentifié

Solution :

# Arrêtez le service
sudo systemctl stop hytale

# Lancez manuellement et authentifiez
sudo -u hytale /opt/hytale/server/start.sh
# Dans la console : /auth login device

Erreur : Failed to load Assets.zip

Cause : Fichier corrompu ou absent

Solution :

# Re-téléchargez les assets
sudo su - hytale
cd /opt/hytale/server
./bin/hytale-downloader --server --force
exit

Optimisation avancée

Configuration réseau VeryCloud

Votre VPS VeryCloud bénéficie déjà de :

• ✅ Protection Anti-DDoS Netrix optimisée pour UDP
• ✅ Réseau AS198825 multi-homing redondant
• ✅ Latence <1ms au sein du datacenter Telehouse 3
• ✅ Bande passante 1 Gbps garantie

Pour maximiser les performances :

# Optimisation kernel pour Hytale (UDP/QUIC)
sudo tee -a /etc/sysctl.conf << EOF

# Hytale Server Optimizations - VeryCloud
net.core.rmem_max = 16777216
net.core.wmem_max = 16777216
net.ipv4.udp_rmem_min = 8192
net.ipv4.udp_wmem_min = 8192
EOF

# Application des paramètres
sudo sysctl -p

Amélioration des performances JVM

Pour les VPS Ryzen haute performance :

# Éditez start.sh
sudo -u hytale nano /opt/hytale/server/start.sh

Ajoutez ces options pour VPS Ryzen 32GB+ :

JAVA_OPTS="-Xms16G -Xmx24G"
JAVA_OPTS="$JAVA_OPTS -XX:+UseZGC"
JAVA_OPTS="$JAVA_OPTS -XX:+ZGenerational"
JAVA_OPTS="$JAVA_OPTS -XX:+UnlockExperimentalVMOptions"
JAVA_OPTS="$JAVA_OPTS -XX:+DisableExplicitGC"
JAVA_OPTS="$JAVA_OPTS -XX:+AlwaysPreTouch"

Ressources et support

Documentation officielle

Support VeryCloud

Communauté Hytale

Récapitulatif des commandes

# === INSTALLATION COMPLÈTE HYTALE SUR VERYCLOUD ===

# 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,logs}
sudo chown -R hytale:hytale /opt/hytale

# 5. Pare-feu
sudo apt install -y ufw
sudo ufw allow 22/tcp
sudo ufw allow 5520/udp
sudo ufw enable

# 6. Téléchargement 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éation script start.sh (voir section Configuration)

# 8. Création service systemd (voir section Configuration)

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

# 10. Authentification
# Arrêter le service et lancer manuellement :
sudo systemctl stop hytale
sudo -u hytale /opt/hytale/server/start.sh
# Dans la console : /auth login device
# Puis valider sur https://accounts.hytale.com/device

# 11. Relance en service
# Ctrl+C pour arrêter, puis :
sudo systemctl start hytale

Checklist de vérification

Avant de mettre votre serveur en production, vérifiez :

Installation

• Java 25 installé et vérifié (java --version)
• Utilisateur hytale créé
• Dossiers /opt/hytale/{server,backups,logs} créés
• Fichiers HytaleServer.jar et Assets.zip téléchargés
• Script start.sh créé et exécutable

Sécurité

• UFW activé et configuré
• Port SSH 22/tcp autorisé
• Port Hytale 5520/udp autorisé
• Serveur lancé avec utilisateur non-root
• Authentification device complétée

Performance

• RAM allouée adaptée au nombre de joueurs
• MaxViewRadius configuré (16 recommandé)
• Service systemd activé pour démarrage automatique
• Logs accessibles via journalctl

Maintenance

• Script de backup créé
• Cron de backup configuré (quotidien à 4h)
• Testez une restauration de backup
• Commandes de gestion maîtrisées

Conclusion

Félicitations ! Votre serveur Hytale est maintenant opérationnel sur votre VPS VeryCloud. Vous bénéficiez :

✅ Infrastructure premium : Datacenter Telehouse Tier 3+, France
✅ Protection Anti-DDoS : Netrix inclus, optimisé UDP
✅ Réseau propriétaire : AS198825, latence <1ms
✅ Support 24/7 : Équipe technique experte disponible
✅ Stockage NVMe : Jusqu'à 7x plus rapide que SSD SATA

Pour aller plus loin :

• Explorez les mods Hytale
• Configurez un nom de domaine personnalisé
• Mettez en place un Discord pour votre communauté
• Optimisez votre config.json selon votre gameplay

Besoin d'aide ?

L'équipe VeryCloud est disponible 24/7 pour vous accompagner :

• Documentation : docs.verycloud.fr
• Support technique : Ouvrez un ticket depuis votre espace client
• Communauté Discord : Rejoindre (600+ membres)
• Statut des services : status.verycloud.fr