Hytale Banner

How to Authenticate your Hytale Game Server

Hytale dedicated servers must authenticate with Hytale services to enable API communication, access Hytale APIs, and help prevent abuse. By default, servers provided through a Game Server Provider (GSP) are authenticated using the provider’s account.

However, servers authenticated via a GSP account will not appear in future Server Discovery. If you want your server to be publicly discoverable later on, you must authenticate it using your own Hytale account.

This guide walks you through switching from Game Server Provider (GSP) authentication to personal account authentication using the official Hytale device login flow, the recommended setup for future Server Discovery.

Hytale Banner
MA
Michi A.
·
5 Minutes
·
Guides

Step 1: Disable GSP Authentication

  1. Open the Settings tab of your server.
  2. Disable Use GSP Authentication.
  3. Restart the server to apply the change.

At this point, your server will intentionally start without valid credentials.

Hytale Auth Guide 1

Step 2: Start Device Authentication from the Console

After the server finishes starting, open the Console tab. You will see a warning similar to:


No server token configured. Use /auth login to authenticate.


In the console command input, type:

auth login device

Then press Enter.

Hytale Auth Guide 2
Hytale Auth Guide 3

Step 3: Open the Device Authorization Link

The server will now print a DEVICE AUTHORIZATION block in the console, similar to this:

DEVICE AUTHORIZATION

===================================================================

Visit: https://accounts.hytale.com/device

Enter code: ABCD-1234

Or visit: https://accounts.hytale.com/device?user_code=ABCD-1234

===================================================================

Waiting for authorization (expires in 900 seconds)...

Click the direct authentication link (the one containing user_code=). This is faster and avoids manual code entry.

Hytale Auth Guide 4

Step 4: Approve the Device and Log In

A browser window will open showing an Authorize Device prompt.

  1. Click Approve to confirm the device request.
  2. You will then be redirected to log in to your Hytale account.
  3. Complete the login to finish authorization.

Only approve requests you initiated and only for servers you trust.

Hytale Auth Guide 5

Step 5: Confirm Successful Authentication

Once authorization is complete:

  • The browser will display a Device Authorized confirmation.
  • The server console will log a success message indicating authentication has completed.
Hytale Auth Guide 6
Hytale Auth Guide 7

Important Notes

  • • Authentication is currently not persistent. You must repeat this process after every server restart.
  • • Credentials are stored in memory only unless persistence is explicitly supported in future Hytale server updates.
  • • This behavior is expected during current development stages.


And that’s how you switch from Game Server Provider authentication to personal account authentication for your Hytale server.

Doing this ensures your server will be eligible for Server Discovery once it’s implemented.

For now, this guide is optional

Looking for your own Hytale server? Jump into the adventure within seconds.
👉[ Get your Hytale Server now ]