Menu
  Log out
 

Hytale Downloader CLI Guide - Automated Server Management

Hytale Guide • Updated Jan 14, 2026

Hytale Downloader CLI Guide: Automated Server Management

For professional server administrators and those running headless Linux servers, the Hytale Downloader CLI is the essential tool for managing your Hytale dedicated server. This guide covers installation, authentication, and automation for Early Access 2026.

🚀 Purpose

Automated fetching of server binaries and Assets.zip without using a GUI launcher.

💻 OS Support

Windows (x64), Linux (x64, arm64)

🔐 Auth Required

Commands require a valid Hytale account with Early Access purchase.

Getting Started

Installation

The Downloader CLI is a standalone binary available for download from the Hytale developer portal.

# Linux (Ubuntu/Debian)
wget https://dl.hytale.com/cli/hytale-cli-linux-x64
chmod +x hytale-cli-linux-x64
sudo mv hytale-cli-linux-x64 /usr/local/bin/hytale-cli

# Verify version
hytale-cli --version

Authentication

To download server files, the CLI must be linked to your account:

  1. Run hytale-cli auth login
  2. A short-link and code (e.g., hytale.com/link ABCD-1234) will appear.
  3. Open the link in your browser and authorize the CLI.
  4. The CLI will now store a session token in ~/.config/hytale/cli.json.

Core CLI Commands

Command Description
hytale-cli get serverDownloads the latest HytaleServer.jar
hytale-cli get assetsDownloads the latest Assets.zip
hytale-cli check-updateChecks if local files match the latest release version
hytale-cli list-versionsLists available server builds (Stable/Experimental)

Automating Updates

One of the biggest advantages of the CLI is the ability to automate updates via cron jobs. Here is a sample bash script (update_hytale.sh) to keep your server up to date:

#!/bin/bash
# Hytale Server Auto-Update Script
SERVER_DIR="/home/hytale/server"
cd $SERVER_DIR

echo "Checking for Hytale updates..."
update_status=$(hytale-cli check-update --json)

if [[ $update_status == *"outdated"* ]]; then
    echo "New update found! Stopping server..."
    # Command to stop your server (e.g., systemctl stop hytale)
    
    hytale-cli get server --force
    hytale-cli get assets --force
    
    echo "Update complete. Restarting server..."
    # Command to start your server
else
    echo "Server is already up to date."
fi

Setting up the Cron Job

# Run check every hour at minute 0
0 * * * * /home/hytale/update_hytale.sh >> /home/hytale/logs/update.log 2>&1

Running on ARM64 (Oracle Ampere / Raspberry Pi)

Hytale official supports ARM64 architecture for the dedicated server. Use the specific ARM build of the CLI:

wget https://dl.hytale.com/cli/hytale-cli-linux-arm64
chmod +x hytale-cli-linux-arm64

Performance Tip: Even on ARM64, ensure you are using Java 25. The server performance on ARM is surprisingly high due to the efficient QUIC protocol handling.

Troubleshooting

Authentication Expired

Tokens typically last 30 days. If your script fails with "Unauthorized", run hytale-cli auth refresh or re-login manually.

Missing Assets.zip

Ensure your CLI has permission to write to the target directory. If running as a service, the user (e.g., hytale) must own the folder.

Checksum Mismatch

If a download is interrupted, use the --verify flag to force a hash check of existing files.

Hosting Hytale on a VPS? Supercraft Hytale Servers use this CLI technology to ensure your server is updated within seconds of a new Hytale release, keeping your community online and up to date automatically.

← Back to Hytale Guides
Top