Come installare un server Hytale su VPS Linux

1. Introduzione

Che cos'è Hytale?

Hytale è un gioco di tipo sandbox sviluppato da Hypixel Studios, uscito in accesso anticipato il 13 gennaio 2026. Combina esplorazione, costruzione, combattimento e creazione di contenuti in un universo procedurale ricco. Il server dedicato consente di ospitare partite multiplayer persistenti.

Caratteristiche principali

• Mondi procedurali con biomi vari
• Sistema di mod e personalizzazione avanzata
• Protocollo di rete moderno QUIC over UDP
• Supporto per architetture x64 e arm64
• Gestione delle autorizzazioni e dei mondi multipli
• Sistema di autenticazione integrato tramite account Hytale

Casi d'uso tipici

• Server privato tra amici (5-10 giocatori)
• Server comunitario pubblico (20-50 giocatori)
• Server di mini-giochi personalizzati
• Server creativo con mod

Versione documentata

• Hytale Server : v1.0.0 (gennaio 2026)
• Java richiesto : OpenJDK 25 LTS (Temurin)

---

🚀 Preferisci una soluzione chiavi in mano?

Con OuiHeberg, il tuo server Hytale è preinstallato e pronto per giocare in meno di 60 secondi. Nessuna configurazione tecnica, aggiornamenti automatici, supporto 24/7 e protezione anti-DDoS inclusa.

➡️ Scopri le nostre offerte di Hosting Hytale

---

2. Requisiti

Configurazione hardware

Risorsa	Minimo	Consigliato	Prestazioni
RAM	4 GB	8 GB	16 GB
CPU	2 vCores	4 vCores	6+ vCores
Storage	10 GB SSD	20 GB SSD	50 GB NVMe
Bandwidth	100 Mbps	1 Gbps	1 Gbps
Giocatori supportati	5-10	10-30	50+

💡 Consiglio : La velocità della CPU (frequenza per core) è più importante del numero di core per Hytale.

Software richiesto

Software	Versione	Obbligatorio
Debian / Ubuntu	12+ / 22.04+	✅
Java (OpenJDK)	25 LTS	✅
unzip	Ultima	✅
UFW (firewall)	Ultima	Consigliato

Porti di rete

Porto	Protocollo	Uso	Obbligatorio
5520	UDP	Server Hytale (QUIC)	✅
22	TCP	SSH (amministrazione)	✅

⚠️ Importante : Hytale utilizza esclusivamente UDP tramite il protocollo QUIC. Non aprire la porta in TCP.

File server richiesti

File	Dimensione	Descrizione
HytaleServer.jar	~50 MB	Eseguibile del server
Assets.zip	~3.2 GB	Risorse del gioco (texture, suoni, modelli)

---

3. Installazione passo dopo passo

Passo 1 : Aggiornamento del sistema

sudo apt update && sudo apt upgrade -y

ℹ️ Questo comando aggiorna l'elenco dei pacchetti e installa le ultime versioni disponibili.

Passo 2 : Installazione di Java 25

Aggiungi il repository Adoptium e installa OpenJDK 25 :

# Installazione delle dipendenze
sudo apt install -y wget apt-transport-https gnupg

# Aggiunta della chiave GPG Adoptium
wget -qO - https://packages.adoptium.net/artifactory/api/gpg/key/public | sudo tee /usr/share/keyrings/adoptium.asc

# Aggiunta del repository
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

# Installazione di Java 25
sudo apt update
sudo apt install -y temurin-25-jdk

Punto di verifica :

java --version

Risultato atteso :

openjdk 25.0.1 2025-10-21 LTS
OpenJDK Runtime Environment 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, mixed mode, sharing)

Passo 3 : Creazione di un utente dedicato

Per motivi di sicurezza, crea un utente di sistema senza privilegi di root :

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

💡 Buona pratica : Non eseguire mai un server di gioco come root.

Passo 4 : Preparazione della struttura

# Creazione delle cartelle
sudo mkdir -p /opt/hytale/server
sudo mkdir -p /opt/hytale/backups

# Assegnazione delle autorizzazioni
sudo chown -R hytale:hytale /opt/hytale

Passo 5 : Download dei file del server

Utilizza lo strumento ufficiale hytale-downloader per scaricare i file del server direttamente sul tuo VPS :

# Connessione come utente hytale
sudo su - hytale
cd /opt/hytale/server

# Download dello strumento
wget -q https://downloader.hytale.com/hytale-downloader.zip

# Estrazione
unzip hytale-downloader.zip

# Assegnazione delle autorizzazioni di esecuzione
chmod +x bin/hytale-downloader

# Download dei file del server (HytaleServer.jar + Assets.zip)
./bin/hytale-downloader --server

ℹ️ Lo strumento ti chiederà di autenticarti con il tuo account Hytale durante il primo download.

Punto di verifica :

ls -lh /opt/hytale/server/

Risultato atteso :

-rw-r--r-- 1 hytale hytale  50M gen 15 10:00 HytaleServer.jar
-rw-r--r-- 1 hytale hytale 3.2G gen 15 10:05 Assets.zip
drwxr-xr-x 2 hytale hytale 4.0K gen 15 10:00 bin/

Passo 6 : Configurazione del firewall

# Attivazione di UFW se necessario
sudo ufw enable

# Apertura della porta SSH (se non già fatto)
sudo ufw allow 22/tcp

# Apertura della porta Hytale (solo UDP)
sudo ufw allow 5520/udp

# Ricaricamento delle regole
sudo ufw reload

# Verifica
sudo ufw status verbose

Risultato atteso :

5520/udp                   ALLOW IN    Anywhere

---

4. Configurazione

Script di avvio

Crea il file /opt/hytale/server/start.sh :

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

Contenuto dello script :

#!/bin/bash
#
# Script di avvio Hytale Server
# OuiHeberg - Guida all'installazione
#

cd /opt/hytale/server

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

# Avvio del server
java $JAVA_OPTS -jar HytaleServer.jar \
    --assets Assets.zip \
    --bind 0.0.0.0:5520

Rendi lo script eseguibile :

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

Ottimizzazione JVM in base al numero di giocatori

Giocatori	RAM VPS	Parametri JVM
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

⚠️ Importante : Lascia sempre 1-2 GB di RAM disponibili per il sistema operativo.

Configurazione del server (config.json)

Dopo il primo avvio, modifica /opt/hytale/server/config.json :

{
  "Version": 3,
  "ServerName": "Il mio server Hytale",
  "MOTD": "Benvenuto nel nostro server!",
  "Password": "",
  "MaxPlayers": 20,
  "MaxViewRadius": 16,
  "LocalCompressionEnabled": false,
  "Defaults": {
    "World": "default",
    "GameMode": "Adventure"
  },
  "ConnectionTimeouts": {
    "JoinTimeouts": {}
  },
  "RateLimit": {},
  "Modules": {},
  "LogLevels": {},
  "Mods": {},
  "DisplayTmpTagsInStrings": false,
  "PlayerStorage": {
    "Type": "Hytale"
  }
}

Parametri importanti :

Parametro	Valore consigliato	Descrizione
ServerName	Il tuo nome	Nome visualizzato nell'elenco dei server
MaxPlayers	20	Numero massimo di giocatori simultanei
MaxViewRadius	16	Distanza di rendering (32 = alta, consuma molto)
Password	""	Vuoto = server pubblico, altrimenti è richiesta una password
GameMode	Adventure	Modalità predefinita : Adventure, Creative, Survival

💡 Ottimizzazione : Ridurre MaxViewRadius da 32 a 16 diminuisce significativamente il consumo di RAM e CPU.

Servizio systemd (avvio automatico)

Crea il file /etc/systemd/system/hytale.service :

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

Contenuto :

[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

# Sicurezza
NoNewPrivileges=true
PrivateTmp=true

[Install]
WantedBy=multi-user.target

Attiva e avvia il servizio :

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

---

5. Prima utilizzo

Primo avvio

sudo systemctl start hytale

Monitora i log in tempo reale :

sudo journalctl -u hytale -f

Uscita attesa :

[INFO] Starting Hytale Server v1.0.0
[INFO] Loading Assets.zip... (1-2 minuti)
[INFO] World generation complete
[WARN] Server requires authentication
[INFO] Use command: /auth login device
[INFO] Server online on port 5520

Autenticazione del server

Accedi alla console del server :

sudo -u hytale screen -S hytale

Oppure tramite systemd :

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

Nella console, digita :

/auth login device

Appare un codice :

===================================================================
AUTORIZZAZIONE DISPOSITIVO
===================================================================
Visita: https://accounts.hytale.com/device
Inserisci codice: ABCD-1234
===================================================================

1. Visita https://accounts.hytale.com/device
2. Inserisci il codice visualizzato (es: ABCD-1234)
3. Conferma con il tuo account Hytale

⚠️ Importante : Il codice scade dopo 15 minuti. L'autenticazione è obbligatoria affinché i giocatori possano connettersi.

Connessione dei giocatori

I giocatori possono connettersi tramite :

• IP diretto : la-tua-ip-pubblica:5520
• Dominio : play.iltuodominio.it:5520

---

6. Manutenzione

Comandi di gestione del servizio

Azioni	Comando
Avviare	sudo systemctl start hytale
Fermare	sudo systemctl stop hytale
Riavviare	sudo systemctl restart hytale
Stato	sudo systemctl status hytale
Log in tempo reale	sudo journalctl -u hytale -f
Log completi	sudo journalctl -u hytale --no-pager

Aggiornamento del server

# Fermare il server
sudo systemctl stop hytale

# Backup prima dell'aggiornamento
sudo -u hytale cp -r /opt/hytale/server /opt/hytale/backups/server-$(date +%Y%m%d)

# Download dei nuovi file
sudo su - hytale
cd /opt/hytale/server
./bin/hytale-downloader --server --update

# Riavvio
exit
sudo systemctl start hytale

Backup automatico

Crea uno script di backup /opt/hytale/backup.sh :

#!/bin/bash
#
# Script di backup Hytale
#

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

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

# Cancellazione dei vecchi backup
find "$BACKUP_DIR" -name "hytale-*.tar.gz" -mtime +$RETENTION_DAYS -delete

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

Rendilo eseguibile e pianificalo :

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

# Aggiunta al cron (backup quotidiano alle 4 del mattino)
echo "0 4 * * * hytale /opt/hytale/backup.sh" | sudo tee /etc/cron.d/hytale-backup

Ripristino

# Fermare il server
sudo systemctl stop hytale

# Ripristino da un backup
cd /opt/hytale/server
sudo -u hytale tar -xzf /opt/hytale/backups/hytale-YYYYMMDD-HHMMSS.tar.gz

# Riavvio
sudo systemctl start hytale

Monitoraggio

Monitora le risorse del server :

# Utilizzo della memoria del processo Java
ps aux | grep HytaleServer

# Utilizzo CPU e RAM in tempo reale
htop -p $(pgrep -f HytaleServer)

# Spazio su disco
df -h /opt/hytale

---

7. Risoluzione dei problemi

Problemi comuni

Problema	Cause	Soluzione
Java version incorrecta	Java < 25	Installare Java 25 tramite Adoptium
Assets.zip non trovato	File mancante	Posizionare Assets.zip in /opt/hytale/server/
Port 5520 già in uso	Altra istanza attiva	sudo lsof -i :5520 poi kill PID
OutOfMemoryError	RAM insufficiente	Aumentare -Xmx o ridurre MaxViewRadius
I giocatori non possono connettersi	Firewall / autenticazione	Controllare UFW + /auth login device

Comandi di diagnostica

# Verificare se il server è in ascolto
sudo ss -ulnp | grep 5520

# Verificare i log di errore
sudo journalctl -u hytale --since "1 hour ago" | grep -i error

# Testare la connettività UDP (da un altro server)
nc -vzu la-tua-ip 5520

# Verificare la versione di Java
java --version

# Verificare le autorizzazioni
ls -la /opt/hytale/server/

Errori frequenti nei log

Errore : GC overhead limit exceeded

# Aumentare la RAM allocata
-Xmx8G invece di -Xmx6G

Errore : Unable to bind to address

# Verificare che nessun altro processo utilizzi la porta
sudo fuser -k 5520/udp

Errore : Authentication required

# Riavviare l'autenticazione
/auth login device

---

8. Risorse

Documentazione ufficiale

Risorsa	URL
Manuale server ufficiale	https://support.hytale.com/hc/en-us/articles/45326769420827-Hytale-Server-Manual
Sito ufficiale Hytale	https://hytale.com
Autenticazione	https://accounts.hytale.com/device
Adoptium (Java 25)	https://adoptium.net

Comunità

Piattaforma	Link
Discord ufficiale	https://discord.gg/hytale
Reddit	https://reddit.com/r/hytale
Forum ufficiali	https://forums.hytale.com

---

💡 L'installazione ti sembra complessa?

Risparmia tempo con un server Hytale preinstallato da OuiHeberg :

• ✅ Server pronto in 60 secondi
• ✅ Pannello di gestione semplificato
• ✅ Aggiornamenti con un clic
• ✅ Backup automatici
• ✅ Supporto tecnico 24/7
• ✅ Protezione anti-DDoS inclusa

➡️ Ordina il tuo server Hytale

---

Riepilogo dei comandi

# === INSTALLAZIONE COMPLETA ===

# 1. Aggiornamento sistema
sudo apt update && sudo apt upgrade -y

# 2. Installazione 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. Creazione utente
sudo adduser --system --group --home /opt/hytale --shell /bin/bash hytale

# 4. Preparazione cartelle
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. Download dei file del server
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. Creare start.sh e hytale.service (vedere sezioni sopra)

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

# 9. Autenticazione
# Nella console: /auth login device
# Poi convalidare su https://accounts.hytale.com/device

---

Guida redatta da OuiHeberg — Ultimo aggiornamento: 15 gennaio 2026