Kundenbereich
Dedicated Servers & VPS•15. Januar 2026• 1145 Aufrufe

Wie man einen Hytale-Server auf einem Linux VPS installiert

Wie man einen Hytale-Server auf einem Linux VPS installiert

Wie man einen Hytale-Server auf einem Linux VPS installiert

1. Einführung

Was ist Hytale?

Hytale ist ein Sandbox-Spiel, das von Hypixel Studios entwickelt wurde und am 13. Januar 2026 im Early Access veröffentlicht wurde. Es kombiniert Erkundung, Bau, Kampf und die Erstellung von Inhalten in einer reichhaltigen prozeduralen Welt. Der dedizierte Server ermöglicht das Hosting von persistenten Multiplayer-Spielen.

Hauptfunktionen

  • Prozedurale Welten mit vielfältigen Biomen
  • Mod-System und erweiterte Anpassungsmöglichkeiten
  • Modernes Netzwerkprotokoll QUIC über UDP
  • Unterstützung für x64- und arm64-Architekturen
  • Verwaltung von Berechtigungen und mehreren Welten
  • Integriertes Authentifizierungssystem über Hytale-Konto

Ty...

2. Voraussetzungen

Hardware-Konfiguration

Ressource Minimum Empfohlen Leistung
RAM 4 GB 8 GB 16 GB
CPU 2 vCores 4 vCores 6+ vCores
Speicher 10 GB SSD 20 GB SSD 50 GB NVMe
Bandbreite 100 Mbps 1 Gbps 1 Gbps
Unterstützte Spieler 5-10 10-30 50+

💡 Tipp: Die CPU-Geschwindigkeit (Kernfrequenz) ist für Hytale wichtiger als die Anzahl der Kerne.

Erforderliche Software

Software Version Erforderlich
Debian / Ubuntu 12+ / 22.04+ ✅
Java (OpenJDK) 25 LTS ✅
unzip Neueste ✅
UFW (Firewall) Neueste Empfohlen

Netzwerkports

Port Protokoll Verwendung Erforderlich
5520 UDP Hytale-Server (QUIC) ✅
22 TCP SSH (Verwaltung) ✅

⚠️ Wichtig: Hytale verwendet ausschließlich UDP über das QUIC-Protokoll. Öffnen Sie den Port nicht in TCP.

Erforderliche Serverdateien

Datei Größe Beschreibung
HytaleServer.jar ~50 MB Ausführbare Serverdatei
Assets.zip ~3,2 GB Spielressourcen (Texturen, Sounds, Modelle)

3. Schrittweise Installation

Schritt 1: Systemupdate

sudo apt update && sudo apt upgrade -y

ℹ️ Dieser Befehl aktualisiert die Paketliste und installiert die neuesten verfügbaren Versionen.

Schritt 2: Installation von Java 25

Fügen Sie das Adoptium-Repository hinzu und installieren Sie OpenJDK 25:

# Installation der Abhängigkeiten
sudo apt install -y wget apt-transport-https gnupg

# Hinzufügen des Adoptium GPG-Schlüssels
wget -qO - https://packages.adoptium.net/artifactory/api/gpg/key/public | sudo tee /usr/share/keyrings/adoptium.asc

# Hinzufügen des Repositories
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 von Java 25
sudo apt update
sudo apt install -y temurin-25-jdk

Überprüfungspunkt:

java --version

Erwartetes Ergebnis:

openjdk 25.0.1 2025-10-21 LTS
OpenJDK Laufzeitumgebung 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, gemischter Modus, gemeinsame Nutzung)

Schritt 3: Erstellen eines dedizierten Benutzers

Zur Sicherheit erstellen Sie einen Systembenutzer ohne Root-Rechte:

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

💡 Best Practice: Führen Sie niemals einen Spiels...

Schritt 4: Vorbereitung der Verzeichnisstruktur

# Erstellen von Ordnern
sudo mkdir -p /opt/hytale/server
sudo mkdir -p /opt/hytale/backups

# Berechtigungen zuweisen
sudo chown -R hytale:hytale /opt/hytale

Schritt 5: Herunterladen der Serverdateien

Verwenden Sie das offizielle Tool hytale-downloader, um die Serverdateien direkt auf Ihrem VPS herunterzuladen:

# Als Benutzer hytale anmelden
sudo su - hytale
cd /opt/hytale/server

# Tool herunterladen
wget -q https://downloader.hytale.com/hytale-downloader.zip

# Entpacken
unzip hytale-downloader.zip

# Ausführungsberechtigungen zuweisen
chmod +x bin/hytale-downloader

# Herunterladen der Serverdateien (HytaleServer.jar + Assets.zip)
./bin/hytale-downloader --server

ℹ️ Das Tool wird Sie beim ersten Download auffordern, sich mit Ihrem Hytale-Konto zu authentifizieren.

Überprüfungspunkt:

ls -lh /opt/hytale/server/

Erwartetes Ergebnis:

-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/

Schritt 6: Firewall-Konfiguration

# UFW aktivieren, falls erforderlich
sudo ufw enable

# SSH-Port öffnen (falls noch nicht geschehen)
sudo ufw allow 22/tcp

# Hytale-Port öffnen (nur UDP)
sudo ufw allow 5520/udp

# Regeln neu laden
sudo ufw reload

# Überprüfung
sudo ufw status verbose

Erwartetes Ergebnis:

5520/udp                   ALLOW IN    Anywhere

4. Konfiguration

Startskript

Erstellen Sie die Datei /opt/hytale/server/start.sh:

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

Skriptinhalt:

#!/bin/bash
#
# Hytale Server Startup Script
# OuiHeberg - Installation Guide
#

cd /opt/hytale/server

# JVM Configuration
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"

# Server Startup
java $JAVA_OPTS -jar HytaleServer.jar \
    --assets Assets.zip \
    --bind 0.0.0.0:5520

Make the script executable:

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

JVM Optimization based on the number of players

Players VPS RAM JVM Parameters
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: Always leave 1-2 GB of RAM available for the operating system.

Server Configuration (config.json)

After the first startup, edit /opt/hytale/server/config.json:

{
  "Version": 3,
  "ServerName": "My Hytale Server",
  "MOTD": "Welcome to our server!",
  "Password": "",
  "MaxPlayers": 20,
  "MaxViewRadius": 16,
  "LocalCompressionEnabled": false,
  "Defaults": {
    "World": "default",
    "GameMode": "Adventure"
  },
  "ConnectionTimeouts": {
    "JoinTimeouts": {}
  },
  "RateLimit": {},
  "Modules": {},
  "LogLevels": {},
  "Mods": {},
  "DisplayTmpTagsInStrings": false,
  "PlayerStorage": {
    "Type": "Hytale"
  }
}

Important Settings:

Parameter Recommended Value Description
ServerName Your Name Name displayed in the server list
MaxPlayers 20 Maximum number of simultaneous players
MaxViewRadius 16 Render distance (32 = high, consumes a lot)
Password "" Empty = public server, otherwise password required
GameMode Adventure Default mode: Adventure, Creative, Survival

💡 Optimization: Reducing MaxViewRadius from 32 to 16 significantly reduces RAM and CPU consumption.

Systemd Service (automatic startup)

Create the file /etc/systemd/system/hytale.service:

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

Content:

[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

# Security
NoNewPrivileges=true
PrivateTmp=true

[Install]
WantedBy=multi-user.target

Enable and start the service:

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

5. First Use

First Startup

sudo systemctl start hytale

Monitor real-time logs:

sudo journalctl -u hytale -f

Expected output:

[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

Server Authentication

Access the server console:

sudo -u hytale screen -S hytale

Or via systemd:

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

In the console, type:

/auth login device

A code will appear:

===================================================================
DEVICE AUTHORIZATION
===================================================================
Visit: https://accounts.hytale.com/device
Enter code: ABCD-1234
===================================================================
  1. Go to https://accounts.hytale.com/device
  2. Enter the displayed code (e.g., ABCD-1234)
  3. Authenticate with your Hytale account

⚠️ Important: The code expires after 15 minutes. Authentication is mandatory for players to connect.

Player Connection

Players can connect via:

  • Direct IP: your-public-ip:5520
  • Domain: play.yourdomain.com:5520

6. Maintenance

Service Management Commands

Action Command
Start sudo systemctl start hytale
Stop sudo systemctl stop hytale
Restart sudo systemctl restart hytale
Status sudo systemctl status hytale
Real-time Logs sudo journalctl -u hytale -f
Full Logs sudo journalctl -u hytale --no-pager

Server Update

# Stop the server
sudo systemctl stop hytale

# Backup before update
sudo -u hytale cp -r /opt/hytale/server /opt/hytale/backups/server-$(date +%Y%m%d)

# Download new files
sudo su - hytale
cd /opt/hytale/server
./bin/hytale-downloader --server --update

# Restart
exit
sudo systemctl start hytale

Automatic Backup

Create a backup script /opt/hytale/backup.sh:

#!/bin/bash
#
# Hytale Backup Script
#

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

# Create backup
tar -czf "$BACKUP_DIR/hytale-$DATE.tar.gz" \
    -C "$SERVER_DIR" \
    config.json \
    universe/ \
    mods/ \
    --exclude='*.log'

# Delete old backups
find "$BACKUP_DIR" -name "hytale-*.tar.gz" -mtime +$RETENTION_DAYS -delete

echo "Backup completed: hytale-$DATE.tar.gz"

Make it executable and schedule it:

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

# Add to cron (daily backup at 4am)
echo "0 4 * * * hytale /opt/hytale/backup.sh" | sudo tee /etc/cron.d/hytale-backup

Restoration

# Server shutdown
sudo systemctl stop hytale

# Restore from backup
cd /opt/hytale/server
sudo -u hytale tar -xzf /opt/hytale/backups/hytale-YYYYMMDD-HHMMSS.tar.gz

# Restart
sudo systemctl start hytale

Überwachung

Überwachen Sie die Ressourcen des Servers:

# Java-Prozessspeicherauslastung
ps aux | grep HytaleServer

# Echtzeit-CPU- und RAM-Auslastung
htop -p $(pgrep -f HytaleServer)

# Festplattenspeicher
df -h /opt/hytale

7. Fehlerbehebung

Gängige Probleme

Problem Ursache Lösung
Java-Version inkorrekt Java < 25 Java 25 über Adoptium installieren
Assets.zip nicht gefunden Fehlende Datei Assets.zip in /opt/hytale/server/ platzieren
Port 5520 bereits in Verwendung Aktive andere Instanz sudo lsof -i :5520 dann kill PID
OutOfMemoryError Unzureichender RAM -Xmx erhöhen oder MaxViewRadius reduzieren
Spieler können nicht verbinden Firewall / Authentifizierung UFW überprüfen + /auth login device

Diagnosebefehle

# Überprüfen, ob der Server zuhört
sudo ss -ulnp | grep 5520

# Fehlerprotokolle überprüfen
sudo journalctl -u hytale --since "1 Stunde zuvor" | grep -i error

# UDP-Konnektivität testen (von einem anderen Server aus)
nc -vzu Ihre-IP 5520

# Java-Version überprüfen
java --version

# Berechtigungen überprüfen
ls -la /opt/hytale/server/

Häufige Fehler in den Protokollen

Fehler: GC overhead limit exceeded

# Zugeordneten RAM erhöhen
-Xmx8G anstelle von -Xmx6G

Fehler: Unable to bind to address

# Überprüfen, ob kein anderer Prozess den Port verwendet
sudo fuser -k 5520/udp

Fehler: Authentication required

# Authentifizierung erneut starten
/auth login device

8. Ressourcen

Offizielle Dokumentation

Ressource URL
Offizielles Serverhandbuch https://support.hytale.com/hc/en-us/articles/45326769420827-Hytale-Server-Manual
Offizielle Hytale-Website https://hytale.com
Authentifizierung https://accounts.hytale.com/device
Adoptium (Java 25) https://adoptium.net

Community

Plattform Link
Offizielles Discord https://discord.gg/hytale
Reddit https://reddit.com/r/hytale
Offizielle Foren https://forums.hytale.com

💡 Finden Sie die Installation komplex?

Sparen Sie Zeit mit einem vorinstallierten Hytale-Server bei OuiHeberg:

  • ✅ Server in 60 Sekunden einsatzbereit
  • ✅ Einfaches Verwaltungspanel
  • ✅ Ein-Klick-Updates
  • ✅ Automatische Backups
  • ✅ 24/7 technischer Support
  • ✅ Inkludierter DDoS-Schutz

➡️ Bestellen Sie Ihren Hytale-Server

Zusammenfassung der Befehle

# === VOLLSTÄNDIGE INSTALLATION ===

# 1. Systemupdate
sudo apt update && sudo apt upgrade -y

# 2. Installation von 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. Benutzer erstellen
sudo adduser --system --group --home /opt/hytale --shell /bin/bash hytale

# 4. Ordner vorbereiten
sudo mkdir -p /opt/hytale/{server,backups}
sudo chown -R hytale:hytale /opt/hytale

# 5. Firewall
sudo ufw allow 5520/udp
sudo ufw reload

# 6. Serverdateien herunterladen
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. start.sh und hytale.service erstellen (siehe oben)

# 8. Starten
sudo systemctl daemon-reload
sudo systemctl enable hytale
sudo systemctl start hytale

# 9. Authentifizierung
# In der Konsole: /auth login device
# Dann auf https://accounts.hytale.com/device bestätigen

Guide by OuiHeberg — Letzte Aktualisierung: 15. Januar 2026

Zurück zur Dokumentation