Installation et Gestion d'un Serveur Hytale¶

Ce guide vous explique comment installer, configurer et administrer un serveur Hytale à l'aide de Docker et Docker Compose.

Hytale est un jeu de type sandbox RPG en monde voxel, alliant aventure, construction et personnalisation dans un univers fantastique.

1. Prérequis¶

Avant de commencer, assurez-vous de disposer de :

Une machine sous Linux (Debian/Ubuntu recommandé)
Docker et Docker Compose installés — voir Installation Docker

2. Installation du Serveur Hytale¶

2.1 Créer le répertoire du projet¶

mkdir -p /opt/docker-compose/hytale
cd /opt/docker-compose/hytale

2.2 Créer le fichier `docker-compose.yml`¶

services:
  hytale:
    image: deinfreu/hytale-server:latest
    container_name: hytale-server
    restart: unless-stopped
    tty: true               # Maintient un pseudo-terminal pour la console du serveur
    stdin_open: true        # Permet de saisir des commandes via docker attach
    ports:
      - "5520:5520/udp"     # Port de connexion au serveur
    environment:
      - SERVER_IP=0.0.0.0   # Écoute sur toutes les interfaces réseau (0.0.0.0 = toutes)
      - SERVER_PORT=5520     # Port UDP du serveur
      - PROD=TRUE            # Mode production : optimisations activées, logs réduits
      - DEBUG=FALSE          # FALSE = logs normaux ; TRUE = logs détaillés pour débogage
      - TZ=Europe/Paris      # Fuseau horaire du serveur
    volumes:
      - ./data:/home/container              # Données du serveur (configs, sauvegardes)
      - /etc/machine-id:/etc/machine-id:ro  # Identifiant machine hôte (requis par le serveur, lecture seule)

📌 Note :

Le volume /etc/machine-id est monté en lecture seule pour permettre au serveur d'identifier la machine hôte.

Le répertoire data/ contiendra les fichiers du serveur (configurations, sauvegardes, etc.).

Les options tty: true et stdin_open: true permettent d'interagir avec la console du serveur si nécessaire.

3. Configuration du Serveur¶

Principaux paramètres disponibles via les variables d'environnement :

Variable	Description	Valeur par défaut
`SERVER_IP`	Adresse IP d'écoute du serveur	`0.0.0.0`
`SERVER_PORT`	Port UDP du serveur	`5520`
`PROD`	Mode production (`TRUE` = optimisé pour prod)	`TRUE`
`DEBUG`	Active les logs de débogage détaillés	`FALSE`
`TZ`	Fuseau horaire du serveur	`Europe/Paris`

▶ 4. Lancer et Gérer le Serveur¶

4.1 Démarrage¶

cd /opt/docker-compose/hytale
docker-compose up -d

4.2 Vérification¶

docker ps

5. Commandes Utiles¶

Action	Commande
🔁 Redémarrer le serveur	`docker-compose restart`
⛔ Arrêter le serveur	`docker-compose down`
📜 Logs en direct	`docker-compose logs -f`
🐚 Accès console serveur	`docker attach hytale-server`
🐚 Accès shell conteneur	`docker exec -it hytale-server /bin/bash`
🔄 Mettre à jour l'image	`docker-compose pull && docker-compose up -d`
🧼 Nettoyage complet	`docker-compose down -v --rmi all --remove-orphans`

💡 Pour accéder à la console interactive du serveur, utilisez docker attach hytale-server. Appuyez sur Ctrl+P puis Ctrl+Q pour vous détacher sans arrêter le conteneur.

6. Connexion au Serveur¶

6.1 Depuis le jeu¶

🎮 Lancez Hytale, puis connectez-vous au serveur avec l'adresse :

<IP_PUBLIQUE>:5520

6.2 Ports nécessaires¶

Assurez-vous que le port suivant est ouvert dans votre pare-feu et redirigé via votre NAT :

5520 UDP — Connexion principale au serveur

7. Arborescence des fichiers¶

/opt/docker-compose/hytale/
├── docker-compose.yml           # Fichier Docker principal
└── data/                        # Données du serveur (configs, sauvegardes, fichiers jeu)

8. Conseils Pratiques¶

Sauvegardes : synchronisez data/ avec un cloud ou un autre disque (rsync, rclone, etc.)
Mode debug : passez DEBUG=TRUE temporairement pour diagnostiquer un problème, puis revenez à FALSE en production.
Logs : consultez les journaux avec docker-compose logs -f pour surveiller l'activité du serveur.

9. Sécurité¶

N'exposez que le port 5520/UDP strictement nécessaire.
Utilisez un pare-feu (ufw, iptables) pour contrôler les accès.
Gardez PROD=TRUE en environnement de production pour des performances optimales.
Sauvegardez régulièrement le dossier data/ pour éviter toute perte de progression.

Conclusion¶

Grâce à Docker, l'installation et la gestion d'un serveur Hytale sont rapides et sans complexité. Vous pouvez maintenant explorer et construire avec vos amis dans l'univers fantastique de Hytale ! ⚔️🌍