Frequently Asked Questions

Find solutions to common issues encountered when setting up or managing your Hytale server.

Hytale server installation issues

Server requires re-authentication after every restart

This happens because the container does not have access to a persistent host machine ID. Without it, the server generates a new identity on each restart.

Docker run:

-v "/etc/machine-id:/etc/machine-id:ro"

Docker Compose:

volumes:
  - /etc/machine-id:/etc/machine-id:ro

WSL2, Unraid, Raspberry Pi: The host's machine-id may not persist reliably. Create a local file instead:

volumes:
  - ./machine-id:/etc/machine-id:ro

Generate it once with: cat /etc/machine-id > ./machine-id (Linux) or [guid]::NewGuid().ToString("N") | Out-File -Encoding ascii -NoNewline .\machine-id (PowerShell).

Linux Permission Errors

If the container crashes or logs file access errors, this is usually a volume permission issue.

sudo chown -R 1000:1000 data

Hytale server Downloads & Updates

How can I update the Hytale server to the latest version?

Create a backup of your server files before performing an update to prevent data loss.

Run the following command to access the terminal inside your container:
```
docker exec -it hytale-server /bin/sh
```
Run the hytale-downloader CLI tool:
```
hytale-downloader
```
Restart the Docker container. The script will automatically install the new files.

How can I download the "pre-release" server version?

You can download the "pre-release" patchline by using the following flag in your docker container:

HYTALE_PATCHLINE: "pre-release"

You can also run the update through the server if you follow the instructions on [this](/documentation/hytale/) page.

Hytale server usage

How can I give myself permissions in-game?

Enable interactive mode by setting tty: true and stdin_open: true in your Docker Compose file, or use docker run -it.

docker attach CONTAINER_NAME

Once attached, run:

/op add USERNAME