Prérequis
- Un VPS ou serveur dédié sous Ubuntu 22.04/24.04, Debian 12 ou AlmaLinux 9/Rocky Linux 9
- Minimum 4 Go de RAM (8 Go recommandé pour 10+ joueurs)
- Accès root ou sudo en SSH
- Un compte Hytale valide (https://accounts.hytale.com)
Hytale est disponible en accès anticipé depuis janvier 2026. Ce guide vous accompagne dans l'installation complète d'un serveur dédié Hytale sous Linux, incluant Java 25, le téléchargement via le downloader officiel, l'authentification OAuth, la configuration du pare-feu (port UDP 5520) et la mise en place d'un service systemd.
Sécurité
Ne lancez jamais un serveur Hytale en tant que root. Créez toujours un utilisateur dédié comme expliqué dans ce tutoriel.
1. Mettre à jour le système
sudo apt update && sudo apt upgrade -y
sudo apt install -y wget curl unzip screen gnupg apt-transport-httpssudo dnf update -y
sudo dnf install -y wget curl unzip screen2. Installer Java 25 (Eclipse Temurin)
Le serveur Hytale nécessite Java 25. Eclipse Temurin (Adoptium) est la distribution recommandée.
# Ajouter la clé GPG Adoptium
wget -qO - https://packages.adoptium.net/artifactory/api/gpg/key/public | \
sudo gpg --dearmor -o /etc/apt/keyrings/adoptium.gpg
# Ajouter le dépôt Adoptium
echo "deb [signed-by=/etc/apt/keyrings/adoptium.gpg] https://packages.adoptium.net/artifactory/deb \
$(. /etc/os-release && echo "$VERSION_CODENAME") main" | \
sudo tee /etc/apt/sources.list.d/adoptium.list
# Installer Java 25
sudo apt update
sudo apt install -y temurin-25-jdk
# Vérifier l'installation
java -version# Ajouter le dépôt Adoptium
cat <<'EOF' | sudo tee /etc/yum.repos.d/adoptium.repo
[Adoptium]
name=Adoptium
baseurl=https://packages.adoptium.net/artifactory/rpm/rhel/$releasever/$basearch
enabled=1
gpgcheck=1
gpgkey=https://packages.adoptium.net/artifactory/api/gpg/key/public
EOF
# Installer Java 25
sudo dnf install -y temurin-25-jdk
# Vérifier l'installation
java -version3. Créer un utilisateur dédié
Créez un utilisateur système dédié au serveur Hytale. Cet utilisateur n'aura pas de mot de passe et ne pourra pas se connecter directement.
# Créer l'utilisateur avec un répertoire home
sudo useradd -m -r -s /bin/bash hytale
# Créer le répertoire du serveur
sudo mkdir -p /home/hytale/server
sudo chown -R hytale:hytale /home/hytale4. Télécharger le serveur Hytale
Le serveur Hytale se télécharge via le downloader officiel disponible sur hytale.com. Le downloader nécessite une authentification OAuth et télécharge une archive d'environ 1.4 Go.
# Basculer vers l'utilisateur hytale
sudo su - hytale
cd ~/server
# Télécharger le downloader officiel
wget https://downloader.hytale.com/hytale-downloader.zip
unzip hytale-downloader.zip
chmod +x hytale-downloader-linux-amd64
# Lancer le downloader (authentification OAuth requise)
./hytale-downloader-linux-amd64Authentification du downloader
Le downloader vous demandera de vous authentifier via oauth.accounts.hytale.com. Suivez les instructions affichées dans le terminal pour compléter la connexion avec votre compte Hytale.
# Extraire l'archive téléchargée (~1.4 Go)
unzip hytale-server-*.zip
# Déplacer les fichiers du serveur à la racine du dossier
mv Server/* ./
rm -rf Server
# Vérifier que les fichiers principaux sont présents
ls -la HytaleServer.jar Assets.zip5. Premier lancement et authentification
Au premier démarrage, le serveur doit être authentifié avec votre compte Hytale via la commande /auth login device.
# Toujours en tant qu'utilisateur hytale
cd ~/server
# Lancer le serveur pour la première fois
java -jar HytaleServer.jar --assets Assets.zipUne fois la console du serveur chargée, tapez la commande d'authentification :
> /auth login device
===================================================================
DEVICE AUTHORIZATION
===================================================================
Visit: https://accounts.hytale.com/device
Enter code: ABCD-1234
Or visit: https://accounts.hytale.com/device?user_code=ABCD-1234
===================================================================
Waiting for authorization (expires in 900 seconds)...
[Ouvrez le lien dans votre navigateur et entrez le code affiché]
> Authentication successful! Mode: OAUTH_DEVICECode d'autorisation
Le code affiché (ex. : ABCD-1234) est unique et expire après 15 minutes. Rendez-vous sur https://accounts.hytale.com/device dans votre navigateur et entrez le code pour autoriser votre serveur.
Une fois l'authentification réussie, arrêtez le serveur avec la commande /stop dans la console. Nous allons maintenant créer un script de démarrage optimisé.
6. Créer un script de démarrage optimisé
Ce script configure la JVM avec des paramètres G1GC optimisés pour un serveur de jeu. Ajustez les valeurs -Xms et -Xmx selon votre RAM disponible.
cat > /home/hytale/server/start.sh << 'EOF'
#!/bin/bash
# Script de démarrage - Serveur Hytale
SERVER_DIR="/home/hytale/server"
SERVER_JAR="HytaleServer.jar"
ASSETS="Assets.zip"
# Arguments JVM optimisés (G1GC)
JVM_ARGS="-server \
-Xms4G \
-Xmx8G \
-XX:+UseG1GC \
-XX:+ParallelRefProcEnabled \
-XX:MaxGCPauseMillis=200 \
-XX:+UnlockExperimentalVMOptions \
-XX:+DisableExplicitGC \
-XX:G1NewSizePercent=30 \
-XX:G1MaxNewSizePercent=40 \
-XX:G1HeapRegionSize=8M \
-XX:G1ReservePercent=20 \
-XX:G1HeapWastePercent=5 \
-XX:G1MixedGCCountTarget=4 \
-XX:InitiatingHeapOccupancyPercent=15 \
-XX:G1MixedGCLiveThresholdPercent=90 \
-XX:G1RSetUpdatingPauseTimePercent=5 \
-XX:SurvivorRatio=32 \
-XX:+PerfDisableSharedMem \
-XX:MaxTenuringThreshold=1"
cd "$SERVER_DIR"
echo "Démarrage du serveur Hytale..."
java $JVM_ARGS -jar "$SERVER_JAR" --assets "$ASSETS" "$@"
EOF
chmod +x /home/hytale/server/start.sh7. Configurer un service systemd
Un service systemd permet de démarrer le serveur automatiquement au boot et de le gérer facilement avec les commandes systemctl.
sudo cat > /etc/systemd/system/hytale.service << 'EOF'
[Unit]
Description=Serveur Hytale
After=network.target
Wants=network-online.target
[Service]
User=hytale
Group=hytale
WorkingDirectory=/home/hytale/server
ExecStart=/home/hytale/server/start.sh
Restart=on-failure
RestartSec=10
StandardInput=null
StandardOutput=journal
StandardError=journal
SyslogIdentifier=hytale
# Sécurité
NoNewPrivileges=true
ProtectSystem=full
ProtectHome=read-only
ReadWritePaths=/home/hytale/server
[Install]
WantedBy=multi-user.target
EOF
# Recharger systemd et activer le service
sudo systemctl daemon-reload
sudo systemctl enable hytale.service
# Commandes utiles :
# sudo systemctl start hytale # Démarrer le serveur
# sudo systemctl stop hytale # Arrêter le serveur
# sudo systemctl restart hytale # Redémarrer le serveur
# sudo systemctl status hytale # Voir l'état du serveur
# sudo journalctl -u hytale -f # Voir les logs en temps réel8. Ouvrir le port dans le pare-feu
Hytale utilise le protocole QUIC sur le port UDP 5520. Vous devez ouvrir ce port dans votre pare-feu pour permettre aux joueurs de se connecter.
Protocole UDP uniquement
Hytale utilise le protocole QUIC (UDP), pas TCP. Assurez-vous d'ouvrir le port 5520 en UDP et non en TCP.
# Autoriser le port Hytale (UDP 5520)
sudo ufw allow 5520/udp comment 'Hytale Server'
# Vérifier la règle
sudo ufw status verbose# Autoriser le port Hytale (UDP 5520)
sudo firewall-cmd --permanent --add-port=5520/udp
# Recharger le pare-feu
sudo firewall-cmd --reload
# Vérifier la règle
sudo firewall-cmd --list-ports9. Utiliser screen pour la console
Si vous préférez lancer le serveur manuellement (sans systemd), utilisez screen pour garder la console active après la déconnexion SSH.
# Basculer vers l'utilisateur hytale
sudo su - hytale
# Créer une session screen nommée "hytale"
screen -S hytale
# Lancer le serveur
cd ~/server
./start.sh
# Pour détacher la session : Ctrl+A puis D
# Pour réattacher la session :
screen -r hytale
# Pour lister les sessions screen actives :
screen -ls10. Résumé des commandes utiles
# Gestion du service
sudo systemctl start hytale # Démarrer
sudo systemctl stop hytale # Arrêter
sudo systemctl restart hytale # Redémarrer
sudo systemctl status hytale # État
sudo journalctl -u hytale -f # Logs en direct
# Console Hytale (commandes dans le serveur)
/auth login device # Authentifier le serveur
/stop # Arrêter proprement le serveur
# Connexion
Port : 5520/UDP (protocole QUIC)
Adresse : votre_ip:5520Serveur prêt !
Votre serveur Hytale est maintenant opérationnel. Partagez votre adresse IP et le port 5520 avec vos amis pour jouer ensemble. Pensez à consulter la documentation officielle de Hytale pour les options de configuration avancées.