[Bug]: Clean install error on validating checksum after download #27

Closed
opened 2026-02-05 16:39:34 +03:00 by OVERLORD · 6 comments
Owner

Originally created by @sabinico on GitHub (Jan 18, 2026).

Panel Type

Pterodactyl Panel

Panel Version

1.11.7

Wings Version

1.11.8

Panel Deployment Method

Bare Metal (Directly on machine)

Wings Deployment Method

Bare Metal (Directly on machine)

Wings Location

Same machine (Local)

Server Architecture

x86_64 (amd64)

When does the issue occur?

During server file download

Bug Description

On a clean install, script fails on checksum validation after downloading server

Console Logs

Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
All packages are up to date.
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
curl is already the newest version (7.88.1-10+deb12u14).
unzip is already the newest version (6.0-28).
jq is already the newest version (1.6-2.1+deb12u1).
0 upgraded, 0 newly installed, 0 to remove and 0 not upgraded.
Starting Hytale downloader installation...
Downloading hytale-downloader.zip...
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100 9492k  100 9492k    0     0  37.5M      0 --:--:-- --:--:-- --:--:-- 37.5M
Extracting hytale-downloader.zip...
Archive:  hytale-downloader.zip
  inflating: hytale-downloader-linux-amd64  
  inflating: hytale-downloader-windows-amd64.exe  
  inflating: QUICKSTART.md           
Cleaning up...
Installation complete!
[Pterodactyl Daemon]: Updating process configuration files...
[Pterodactyl Daemon]: Ensuring file permissions are set correctly, this could take a few seconds...
container@pterodactyl~ Server marked as starting...
[Pterodactyl Daemon]: Pulling Docker container image, this could take a few minutes to complete...
Pulling from natroutter/egg-hytale 
Digest: sha256:8eaa98d9cda7ca23e9ad1af5a28953a4fc0702d9454d8e3214e11e9245a0f612 
Status: Image is up to date for ghcr.io/natroutter/egg-hytale:latest 
[Pterodactyl Daemon]: Finished pulling Docker container image
openjdk version "25.0.1" 2025-10-21 LTS
OpenJDK Runtime Environment Temurin-25.0.1+8 (build 25.0.1+8-LTS)
OpenJDK 64-Bit Server VM Temurin-25.0.1+8 (build 25.0.1+8-LTS, mixed mode, sharing)
 
ℹ Platform: x86_64
ℹ Copying start.sh template to /home/container...
ℹ Creating version check file...
⚠ Credentials file not found, running initial setup...
ℹ Downloading server files...
hytale-downloader is up to date (2026.01.09-49e5904)
 
╔══════════════════════════════════════════════════════════════════════════════════════╗
║  NOTE: You must have purchased Hytale on the account you are using to authenticate.  ║
╚══════════════════════════════════════════════════════════════════════════════════════╝
 
Please visit the following URL to authenticate:
https://oauth.accounts.hytale.com/oauth2/device/verify?user_code=XXXXXX
Or visit the following URL and enter the code:
https://oauth.accounts.hytale.com/oauth2/device/verify
Authorization code: XXXXXX
downloading latest ("release" patchline) to "server.zip"
[==================================================] 100.0% (1.4 GB / 1.4 GB)B)
validating checksum...
2026/01/17 22:08:29 error downloading: error validating checksum: checksum mismatch: expected 1b3889f5890c80201ed7c3a9b4b7ee571d0dd21024a56f2c01fe2e7e66ee316f, got 7a1c896ad58ed527024794fa969141ce597e40c3a13bdd02b2f3253cd48538e4
⨯ Failed to download Hytale server files.
⚠ Removing invalid credential file...
container@pterodactyl~ Server marked as offline...
[Pterodactyl Daemon]: ---------- Detected server process in a crashed state! ----------
[Pterodactyl Daemon]: Exit code: 1
[Pterodactyl Daemon]: Out of memory: false

Additional Context

No response

Pre-submission Checklist

  • I have searched existing issues to make sure this bug hasn't already been reported
  • I have verified that I own Hytale on the account I'm using for authentication
  • I am using the latest version of the egg
Originally created by @sabinico on GitHub (Jan 18, 2026). ### Panel Type Pterodactyl Panel ### Panel Version 1.11.7 ### Wings Version 1.11.8 ### Panel Deployment Method Bare Metal (Directly on machine) ### Wings Deployment Method Bare Metal (Directly on machine) ### Wings Location Same machine (Local) ### Server Architecture x86_64 (amd64) ### When does the issue occur? During server file download ### Bug Description On a clean install, script fails on checksum validation after downloading server ### Console Logs ```shell Reading package lists... Done Building dependency tree... Done Reading state information... Done All packages are up to date. Reading package lists... Done Building dependency tree... Done Reading state information... Done curl is already the newest version (7.88.1-10+deb12u14). unzip is already the newest version (6.0-28). jq is already the newest version (1.6-2.1+deb12u1). 0 upgraded, 0 newly installed, 0 to remove and 0 not upgraded. Starting Hytale downloader installation... Downloading hytale-downloader.zip... % Total % Received % Xferd Average Speed Time Time Time Current Dload Upload Total Spent Left Speed 100 9492k 100 9492k 0 0 37.5M 0 --:--:-- --:--:-- --:--:-- 37.5M Extracting hytale-downloader.zip... Archive: hytale-downloader.zip inflating: hytale-downloader-linux-amd64 inflating: hytale-downloader-windows-amd64.exe inflating: QUICKSTART.md Cleaning up... Installation complete! [Pterodactyl Daemon]: Updating process configuration files... [Pterodactyl Daemon]: Ensuring file permissions are set correctly, this could take a few seconds... container@pterodactyl~ Server marked as starting... [Pterodactyl Daemon]: Pulling Docker container image, this could take a few minutes to complete... Pulling from natroutter/egg-hytale Digest: sha256:8eaa98d9cda7ca23e9ad1af5a28953a4fc0702d9454d8e3214e11e9245a0f612 Status: Image is up to date for ghcr.io/natroutter/egg-hytale:latest [Pterodactyl Daemon]: Finished pulling Docker container image openjdk version "25.0.1" 2025-10-21 LTS OpenJDK Runtime Environment Temurin-25.0.1+8 (build 25.0.1+8-LTS) OpenJDK 64-Bit Server VM Temurin-25.0.1+8 (build 25.0.1+8-LTS, mixed mode, sharing) ℹ Platform: x86_64 ℹ Copying start.sh template to /home/container... ℹ Creating version check file... ⚠ Credentials file not found, running initial setup... ℹ Downloading server files... hytale-downloader is up to date (2026.01.09-49e5904) ╔══════════════════════════════════════════════════════════════════════════════════════╗ ║ NOTE: You must have purchased Hytale on the account you are using to authenticate. ║ ╚══════════════════════════════════════════════════════════════════════════════════════╝ Please visit the following URL to authenticate: https://oauth.accounts.hytale.com/oauth2/device/verify?user_code=XXXXXX Or visit the following URL and enter the code: https://oauth.accounts.hytale.com/oauth2/device/verify Authorization code: XXXXXX downloading latest ("release" patchline) to "server.zip" [==================================================] 100.0% (1.4 GB / 1.4 GB)B) validating checksum... 2026/01/17 22:08:29 error downloading: error validating checksum: checksum mismatch: expected 1b3889f5890c80201ed7c3a9b4b7ee571d0dd21024a56f2c01fe2e7e66ee316f, got 7a1c896ad58ed527024794fa969141ce597e40c3a13bdd02b2f3253cd48538e4 ⨯ Failed to download Hytale server files. ⚠ Removing invalid credential file... container@pterodactyl~ Server marked as offline... [Pterodactyl Daemon]: ---------- Detected server process in a crashed state! ---------- [Pterodactyl Daemon]: Exit code: 1 [Pterodactyl Daemon]: Out of memory: false ``` ### Additional Context _No response_ ### Pre-submission Checklist - [x] I have searched existing issues to make sure this bug hasn't already been reported - [x] I have verified that I own Hytale on the account I'm using for authentication - [x] I am using the latest version of the egg
OVERLORD added the bug label 2026-02-05 16:39:34 +03:00
Author
Owner

@NATroutter commented on GitHub (Jan 18, 2026):

Does this happen each time you try to do it ?

@NATroutter commented on GitHub (Jan 18, 2026): Does this happen each time you try to do it ?
Author
Owner

@sabinico commented on GitHub (Jan 18, 2026):

Does this happen each time you try to do it ?

Yes, tried several times on same instance and deleted and created a new fresh instance a few times

@sabinico commented on GitHub (Jan 18, 2026): > Does this happen each time you try to do it ? Yes, tried several times on same instance and deleted and created a new fresh instance a few times
Author
Owner

@NATroutter commented on GitHub (Jan 18, 2026):

Do you have latest egg file ?

@NATroutter commented on GitHub (Jan 18, 2026): Do you have latest egg file ?
Author
Owner

@sabinico commented on GitHub (Jan 18, 2026):

Do you have latest egg file ?

Yes, latest egg file, docker image updated and everything up to date.

Fixed my issue manually downloading on other machine and uploading the server files to skip the validation checksum, but I'm still worried the problem can persist on new installs or updates

@sabinico commented on GitHub (Jan 18, 2026): > Do you have latest egg file ? Yes, latest egg file, docker image updated and everything up to date. Fixed my issue manually downloading on other machine and uploading the server files to skip the validation checksum, but I'm still worried the problem can persist on new installs or updates
Author
Owner

@NATroutter commented on GitHub (Jan 18, 2026):

I’ve tried this on both Pterodactyl and Pelican, on ARM and x86 systems, and I wasn’t able to reproduce the issue.

If we’re being precise, this isn’t directly an egg issue, but more likely an environment / hytale-downloader issue. Still, I’m happy to help as best as I can. Here are some possible causes that I think might be responsible:

  • Unstable Network: Packet loss or interruption causing the file to be saved incorrectly.
  • Transparent Proxy/Caching: An ISP or datacenter firewall caching a corrupted version of the file.
  • Disk I/O Issues: The storage might be having trouble writing the large file correctly

You could also try running the downloader directly on the host machine to see if it works or not.

@NATroutter commented on GitHub (Jan 18, 2026): I’ve tried this on both Pterodactyl and Pelican, on ARM and x86 systems, and I wasn’t able to reproduce the issue. If we’re being precise, this isn’t directly an egg issue, but more likely an environment / hytale-downloader issue. Still, I’m happy to help as best as I can. Here are some possible causes that I think might be responsible: - **Unstable Network:** Packet loss or interruption causing the file to be saved incorrectly. - **Transparent Proxy/Caching:** An ISP or datacenter firewall caching a corrupted version of the file. - **Disk I/O Issues:** The storage might be having trouble writing the large file correctly You could also try running the downloader directly on the host machine to see if it works or not.
Author
Owner

@sabinico commented on GitHub (Jan 18, 2026):

I tried now after a few hours and seems to be working fine.

I guess it was some caching related problem in my side

I appreciate your help anyway, thank you!

@sabinico commented on GitHub (Jan 18, 2026): I tried now after a few hours and seems to be working fine. I guess it was some caching related problem in my side I appreciate your help anyway, thank you!
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/egg-hytale#27