Instalacja serwera Hytale na Debianie lub Ubuntu

Chcesz prowadzić własny serwer Hytale na swoim systemie operacyjnym Linux pod Debianem albo Ubuntu? Ten poradnik jest właśnie dla ciebie.

W tym poradniku korzystamy z oficjalnego downloadera Hytale, instalujemy serwer krok po kroku i przeprowadzamy pierwsze uwierzytelnienie. Wszystkie polecenia są przygotowane pod Debiana 13, Debiana 12 i Ubuntu 24.04 LTS.

Wymagania do uruchomienia własnego serwera Hytale

• Serwer root lub VPS z Debianem 13, Debianem 12 albo Ubuntu 24.04 LTS
• Dostęp root przez SSH
• Co najmniej 4 GB pamięci RAM na sam serwer, w przykładzie poniżej pracujemy z 8 GB
• Java 25, patrz następny rozdział

Zaktualizuj listę pakietów i wgraj aktualizacje

Zanim zaczniemy, zaktualizuj listę pakietów swojego systemu operacyjnego i zainstaluj wszystkie dostępne aktualizacje:

apt update && apt upgrade -y

Instalacja Javy 25

Oficjalny Hytale Server Manual wymaga bezwzględnie Javy 25. Na starszych wydaniach Javy serwer nie wystartuje. Zainstaluj Javę 25 razem z unzip i screen:

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

Następnie sprawdź instalację poniższym poleceniem. W wyniku powinno pojawić się „openjdk 25”:

java -version

Nie każda dystrybucja ma Javę 25 w swoich źródłach pakietów. Stan na lipiec 2026:

Na Debianie 12 zainstalujesz Javę 25 przez źródło pakietów Adoptium. Klucz podpisu trafia przy tym do /etc/apt/keyrings/, wcześniejsza droga przez apt-key odpadła:

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

To, które wersje Javy są dostępne w twoim systemie, sprawdzisz w każdej chwili poleceniem:

apt-cache policy openjdk-25-jre-headless

Załóż osobnego użytkownika dla serwera Hytale

Ze względów bezpieczeństwa nie uruchamiaj serwera jako root, tylko na koncie osobnego użytkownika:

adduser --disabled-login hytale

Pytania o imię, adres czy numer telefonu pomijasz po prostu klawiszem Enter. Potem przejdź na nowego użytkownika i do jego katalogu domowego:

su hytale && cd

Pobierz downloader Hytale i ściągnij pliki serwera

Pobierz oficjalny downloader Hytale bezpośrednio na serwer:

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

Rozpakuj archiwum. Ponieważ zawiera ono już katalog o nazwie Server/, przenosimy tam plik Assets.zip, jeśli leży osobno, wchodzimy do tego katalogu i nadajemy downloaderowi prawo wykonywania:

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

Teraz uruchamiamy downloader, żeby pobrać albo zaktualizować właściwe pliki serwera:

./hytale-downloader-linux-amd64

Wskazówka: downloader pobiera za każdym razem aktualne wydanie plików HytaleServer.jar i Assets.zip. Dlatego uruchamiaj go również przy późniejszych aktualizacjach.

Utwórz skrypt startowy z cache'em AOT

Utwórz plik „start.sh”:

nano start.sh

Wpisz następującą zawartość. Korzystamy tu z zalecanego w manualu cache'u AOT, który wyraźnie skraca czas startu:

#!/bin/bash
# KONFIGURACJA
SCREEN_NAME="hytale"
SERVER_FILE="HytaleServer.jar"
ASSETS_FILE="Assets.zip" # nazwa standardowa
MEM="8G" # Dopasuj RAM do swoich potrzeb (min. 4GB)

# PĘTLA STARTOWA
while true; do
    echo "Uruchamianie serwera Hytale..."
    # Polecenie startowe z optymalizacją cache AOT zgodnie z manualem
    java -Xms$MEM -Xmx$MEM -XX:AOTCache=HytaleServer.aot -jar $SERVER_FILE --assets $ASSETS_FILE

    echo "Restart za 5 sekund... CTRL+C, aby przerwać"
    sleep 5
done

Plik zapiszesz kombinacją „CTRL + X”, potem „Y” i „Enter”. Pętla w skrypcie dba o to, żeby serwer po awarii uruchamiał się automatycznie na nowo.

Nadaj skryptowi prawo wykonywania:

chmod +x start.sh

Uruchom serwer Hytale i obsłuż konsolę

Uruchom serwer w sesji screen, żeby działał dalej także po zamknięciu twojego połączenia SSH:

screen -dmS hytale ./start.sh

Konsolę otworzysz poleceniem:

screen -r hytale

Kombinacją „CTRL + A + D” opuścisz konsolę, nie kończąc pracy serwera.

Uwierzytelnij serwer (Device Login)

Przy pierwszym uruchomieniu musisz jednorazowo uwierzytelnić serwer. Wpisz w tym celu w konsoli serwera następujące polecenie:

/auth login device

Odwiedź wyświetlony link (na przykład https://accounts.hytale.com/device) na swoim komputerze i wpisz tam kod, który widnieje w konsoli. Gdy tylko pojawi się „Authentication successful!”, twój serwer jest gotowy do pracy.

Kolejne kroki: automatyczny start i ochrona przed atakami

• Automatyczny start: Żeby serwer Hytale sam wstawał po restarcie systemu operacyjnego, skonfiguruj automatyczny start. Cały przebieg opisuje nasz poradnik Automatyczne uruchamianie programów przy starcie serwera.
• Ochrona przed atakami DDoS: Serwery gier to ulubiony cel ataków z sieci. Na co przy tym zwrócić uwagę, przeczytasz we wpisie Serwer Hytale i ochrona DDoS.