Installation et Gestion d'un Serveur Hytale¶

Rien ne vaut un serveur bien à soi pour accueillir ses amis dans un monde qui dure — sans location, sans limites, entièrement sous votre contrôle.

Hytale se veut l'héritier ambitieux du bac à sable voxel : aventure, construction et RPG dans un univers fantastique taillé pour la créativité et le jeu communautaire. Ce guide prépare le serveur dédié avec Docker et Docker Compose, prêt à héberger votre coin de ce monde.

Jeu en cours de développement

Hytale n'est pas encore sorti au grand public : selon l'état du projet, l'image et les paramètres du serveur peuvent évoluer. Considérez ce guide comme une base à adapter aux versions officielles à venir.

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 ! ⚔️🌍