How do I authorize my Hytale server?
How to Authorize Your Hytale Server (AleForge, Self-Hosting & Other Hosts)
Section titled “How to Authorize Your Hytale Server (AleForge, Self-Hosting & Other Hosts)”Before your Hytale server can download the files it needs and let players join, it has to be authorized with your Hytale account. It only takes a minute: the server gives you a short code, you approve it in your browser, and you’re done.
This guide shows you how to do it on your AleForge server, and also covers self-hosting and other providers.
Quick version: Start your server, run
/auth login devicein the Console, open the link it prints, enter the code and click Approve. When the Console says Authentication successful!, you’re done.
Authorizing Your Server on AleForge
Section titled “Authorizing Your Server on AleForge”Step 1: Open the Console
Section titled “Step 1: Open the Console”- Log in to the AleForge Panel and select your Hytale server.
- Open the Console page.
Step 2: Start Your Server
Section titled “Step 2: Start Your Server”Click the Start button. As the server boots, you may see a warning in the Console telling you that no server tokens are configured and to authenticate. That’s normal, and it just means the server hasn’t been authorized yet.
Step 3: Get Your Authorization Code
Section titled “Step 3: Get Your Authorization Code”If the Console doesn’t print a code on its own, type this command in the command box at the bottom of the Console and press Enter:
/auth login deviceIf your console doesn’t accept the leading slash, type it without: auth login device.
The server starts a device login and prints a block of text like this:
- A website link to visit
- A short authorization code
- A direct link that already includes your code
- A note that the code expires in 600 seconds (10 minutes)
Tip:
auth loginhas two options,deviceandbrowser. On a hosted server, always usedevice. Thebrowseroption needs a web browser on the same machine as the server.
Step 4: Copy the Code
Section titled “Step 4: Copy the Code”Copy the authorization code from the Console. If you’d like to skip typing it, use the direct link marked “Or visit” instead. It opens the Hytale page with your code already filled in.
Step 5: Sign In to Hytale
Section titled “Step 5: Sign In to Hytale”Open the Hytale device verification page and sign in with your Hytale account.
Step 6: Enter Your Code
Section titled “Step 6: Enter Your Code”Paste the authorization code you copied and continue.
Step 7: Approve the Request
Section titled “Step 7: Approve the Request”When Hytale asks for permission to access your account, click Approve.
Step 8: Check the Console for Success
Section titled “Step 8: Check the Console for Success”Go back to the Console. Within a few seconds of approving, you should see messages confirming that your server signed in, ending with a green “Authentication successful!” line.
Here is what those messages mean:
- Found game profile: The server found the Hytale profile on your account and selected it.
- Successfully created game session: Your server is now connected to Hytale’s online services.
- Token refresh scheduled: The server renews its sign-in automatically, so you don’t need to do anything.
- Authentication successful: You’re authorized. The Console also confirms that your credentials were saved in encrypted form.
To check your sign-in at any time, type /auth status in the Console.
Step 9: Wait for the Download
Section titled “Step 9: Wait for the Download”Your server will now begin downloading the files it needs. This can take a few minutes, and your server will be ready to join when it finishes starting up.
Self-Hosting or Using Another Provider
Section titled “Self-Hosting or Using Another Provider”The process is the same wherever your server runs.
- Start your server and open its console.
- Run
/auth login deviceif the server doesn’t print a code on its own. - Copy the authorization code.
- Sign in at the Hytale device verification page.
- Paste the code you copied.
- When Hytale asks for permission to access your account, click Approve.
- Check the console for a green Authentication successful! message. You can run
/auth statusat any time to check your sign-in.
If you’re setting up a server on your own PC, our full walkthrough is here: How to Host a Hytale Dedicated Server (Easy Guide).
Stay Safe When Authorizing
Section titled “Stay Safe When Authorizing”- Only approve codes you started. Authorizing gives a server access to your Hytale account. Never enter or approve a code that someone else sends you.
- Don’t share your code. Codes expire quickly, but treat them like a password and keep screenshots of the Console private until they’ve expired.
- Check the address. Make sure you’re on the official Hytale sign-in page before you enter your details.
- Blur your screenshots. The Console shows your Hytale profile name and ID after you sign in, so hide them before you post a screenshot publicly.
Troubleshooting
Section titled “Troubleshooting”- “No server tokens configured” warning: This appears before you authorize. Run
/auth login deviceand complete the steps above, and it will go away. - “Command not found: browser”: Use
/auth login deviceinstead. Thebrowseroption isn’t available on hosted servers. - The code expired: Codes last 10 minutes. Run
/auth login deviceagain to get a new code. - Nothing happens after approving: Check the Console for new messages, and give the server a few minutes to download its files.
- You signed in to the wrong account: Run the command again and sign in with the account that owns Hytale.
- Not sure it worked: Run
/auth statusin the Console to check your sign-in. If you’re asked to authorize again later, for example after a game update, repeat the same steps. Hytale is still in Early Access. - Still stuck? Contact AleForge support 24/7 through a ticket, live chat or the community Discord.
Frequently Asked Questions
Section titled “Frequently Asked Questions”Why does my Hytale server need to be authorized?
Section titled “Why does my Hytale server need to be authorized?”Hytale requires a server to sign in with a valid Hytale account before it can download its files and let players connect.
What command do I use to authorize my server?
Section titled “What command do I use to authorize my server?”Use /auth login device in the server console. It prints a link and a code that you approve in your browser.
How long does the code last?
Section titled “How long does the code last?”10 minutes (600 seconds). If it expires, run the command again to get a new one.
Do I need to own Hytale?
Section titled “Do I need to own Hytale?”Yes. The server signs in with a Hytale account.
Is it safe to approve the request?
Section titled “Is it safe to approve the request?”It’s safe when you started the request yourself. Never approve a code someone else gave you.
Need a Hytale Server?
Section titled “Need a Hytale Server?”AleForge’s Hytale server hosting gives you an always-online world with a simple control panel, backups, DDoS protection and 24/7 support, with no port forwarding needed.