Frequently Asked Questions

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

Installation

Server requires re-authentication after every restart

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

Mount the machine-id volume:

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

Docker run:

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

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

I can't run the server on ARM64

The hytale-downloader CLI tool does not currently support ARM64.

Updates & game files.

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.

In-game commands

How can I give myself permissions in-game?

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

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