Hytale-server installeren op Debian of Ubuntu

Wilt u een eigen Hytale-server draaien op uw Linux-besturingssysteem met Debian of Ubuntu? Dan bent u hier aan het juiste adres.

In deze handleiding gebruiken wij de officiële Hytale-downloader, installeren wij de server stap voor stap en voeren wij de eerste authenticatie uit. Alle commando's zijn afgestemd op Debian 13, Debian 12 en Ubuntu 24.04 LTS.

Voorwaarden voor een eigen Hytale-server

• Een rootserver of VPS met Debian 13, Debian 12 of Ubuntu 24.04 LTS
• Roottoegang via SSH
• Minimaal 4 GB werkgeheugen alleen al voor de server, in het voorbeeld hieronder werken wij met 8 GB
• Java 25, zie de volgende sectie

Pakketlijst bijwerken en updates installeren

Voordat wij beginnen, werkt u de pakketlijst van uw besturingssysteem bij en installeert u alle beschikbare updates:

apt update && apt upgrade -y

Java 25 installeren

Volgens de officiële Hytale Server Manual is Java 25 verplicht. Met oudere Java-versies start de server niet. Installeer Java 25 samen met unzip en screen:

apt install openjdk-25-jre-headless unzip screen -y

Controleer de installatie daarna met het volgende commando. In de uitvoer moet "openjdk 25" staan:

java -version

Java 25 is niet in elke distributie beschikbaar. De stand van juli 2026:

Op Debian 12 installeert u Java 25 via de pakketbron van Adoptium. De handtekeningsleutel hoort daarbij thuis in /etc/apt/keyrings/, want de vroegere route via apt-key is vervallen:

apt install -y wget gpg apt-transport-https
mkdir -p /etc/apt/keyrings
wget -qO- https://packages.adoptium.net/artifactory/api/gpg/key/public | gpg --dearmor -o /etc/apt/keyrings/adoptium.gpg
echo "deb [signed-by=/etc/apt/keyrings/adoptium.gpg] https://packages.adoptium.net/artifactory/deb $(awk -F= '/^VERSION_CODENAME/{print$2}' /etc/os-release) main" | tee /etc/apt/sources.list.d/adoptium.list
apt update
apt install -y temurin-25-jre unzip screen

Welke Java-versies op uw systeem klaarstaan, ziet u op elk moment met:

apt-cache policy openjdk-25-jre-headless

Een eigen gebruiker voor de Hytale-server aanmaken

Draai de server om veiligheidsredenen niet als root, maar onder een eigen gebruiker:

adduser --disabled-login hytale

De vragen om naam, adres of telefoonnummer slaat u eenvoudig over met de Enter-toets. Wissel daarna naar de nieuwe gebruiker en naar diens homedirectory:

su hytale && cd

Hytale-downloader downloaden en de serverbestanden ophalen

Download de officiële Hytale-downloader rechtstreeks:

wget https://downloader.hytale.com/hytale-downloader.zip

Pak het archief uit. Omdat het al een map met de naam Server/ bevat, verplaatsen wij een eventueel apart meegeleverde Assets.zip daarnaartoe, wisselen wij naar die map en maken wij de downloader uitvoerbaar:

unzip hytale-downloader.zip
mv Assets.zip Server/
cd Server/
chmod +x hytale-downloader-linux-amd64

Nu voeren wij de downloader uit om de eigenlijke serverbestanden op te halen of bij te werken:

./hytale-downloader-linux-amd64

Let op: de downloader haalt telkens de actuele versie van HytaleServer.jar en Assets.zip op. Voer hem daarom ook bij latere updates opnieuw uit.

Startscript met AOT-cache maken

Maak een bestand "start.sh" aan:

nano start.sh

Voer de volgende inhoud in. Wij gebruiken hier de AOT-cache die Hytale in de officiële handleiding aanbeveelt, want die verkort de starttijd merkbaar:

#!/bin/bash
# CONFIGURATIE
SCREEN_NAME="hytale"
SERVER_FILE="HytaleServer.jar"
ASSETS_FILE="Assets.zip" # standaardnaam
MEM="8G" # Pas het RAM aan uw behoeften aan (min. 4GB)

# STARTLUS
while true; do
    echo "Hytale-server wordt gestart..."
    # Startcommando met AOT-cache-optimalisatie volgens de officiële handleiding
    java -Xms$MEM -Xmx$MEM -XX:AOTCache=HytaleServer.aot -jar $SERVER_FILE --assets $ASSETS_FILE

    echo "Herstart over 5 seconden... CTRL+C om af te breken"
    sleep 5
done

Sla het bestand op met "CTRL + X", dan "Y" en "Enter". De lus in het script zorgt ervoor dat de server na een crash automatisch opnieuw start.

Maak het script uitvoerbaar:

chmod +x start.sh

Hytale-server starten en de console bedienen

Start de server in een screen-sessie, zodat hij blijft draaien nadat u uw SSH-verbinding hebt verbroken:

screen -dmS hytale ./start.sh

De console opent u met:

screen -r hytale

Met "CTRL + A + D" verlaat u de console weer, zonder de server af te sluiten.

Server authenticeren (device login)

Bij de eerste start moet u de server eenmalig authenticeren. Voer daarvoor in de serverconsole het volgende commando in:

/auth login device

Open de weergegeven link (bijvoorbeeld https://accounts.hytale.com/device) op uw pc en voer daar de code in die in de console staat. Zodra "Authentication successful!" verschijnt, is uw server gebruiksklaar.

Volgende stappen: automatisch starten en bescherming tegen aanvallen

• Automatisch starten: Om de Hytale-server na een herstart van het besturingssysteem vanzelf weer op te laten komen, richt u een autostart in. Het verloop beschrijft onze handleiding Programma's automatisch uitvoeren bij de serverstart.
• Bescherming tegen DDoS-aanvallen: Gameservers zijn een geliefd doelwit voor aanvallen vanaf het internet. Waar u daarbij op moet letten, leest u in ons artikel Hytale-server en DDoS-bescherming.