❓ FAQ

Frequently Asked Questions

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

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, and the script will automatically install the new files.

How can I give myself permissions in-game?

You can attach to the server console using the following command:

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

docker attach CONTAINER_NAME

Once attached, use the following command to give yourself operator status:

/op add USERNAME

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.

How to fix

Mount the machine-id volume in your Docker Compose file: "/etc/machine-id:/etc/machine-id:ro". For Docker run, use -v "/etc/machine-id:/etc/machine-id:ro".

Linux Permission Errors

If the container crashes or logs errors regarding file access, it is likely a permission issue with your mounted volume.

Test with full permissions: Try setting full permissions on the data directory to verify if this solves the issue.
```
 chmod -R 777 [volume folder]
```
Secure the permissions: If the server runs successfully after step 1, revert to safer permissions to secure your server.
```
 chmod -R 644 [volume folder]
```
Directory navigation issues: If setting permissions to 644 prevents folder navigation or access, you may need to use 755 for directories specifically.
```
 chmod -R 755 [volume folder]
```

I can’t run the server on ARM64

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

How to fix

Currently waiting for Hytale to release the ARM64 version of this tool. See the announcement here.

My logs don’t show the correct date or time

By default, Docker containers run in Coordinated Universal Time (UTC). To synchronize the server logs with your local time, define the TZ (Time Zone) environment variable.

How to fix

Consult the List of TZ Database Time Zones.
Locate your location in the “TZ identifier” column (e.g., America/New_York or Europe/Paris).

Add the variable to your deployment:

Docker CLI:

 docker run -e TZ="Europe/Brussels" ...

Docker Compose:

 services:
   hytale:
     environment:
       - TZ=Europe/Brussels