LibreAuth Nut.exe Visit Website

Troubleshooting

Common errors and how to fix them — with links to full API docs.

Hash Check Failed

WARN
Got {"success":false,"message":"Hash check failed"}? Client sends a hash — but it does not match Panel whitelist.
  1. Open Panel → App → Hash Management
  2. Drag & drop your compiled .exe (Release build, same file users run)
  3. Client must send that exact MD5 on every init as hash=
  4. Rebuild client after changing exe — old MD5 will fail

Full docs: Initialization → Common Errors · Anti-Tamper

// Windows — get MD5 of exe (PowerShell)
Get-FileHash -Algorithm MD5 ".\YourApp.exe"

API / Client Errors

ErrorFix
Missing signature headersEnable PHP sodium · run upgrade.php
Signature verification failedReplace C++ public key from Response Signing · rebuild
Invalid credentialsWrong name or ownerid · app deleted
invalidverClient version ≠ panel App Version
Hash required / Hash check failedHash troubleshooting · init docs
Invalid nonceDisable Nonce Chain or update client SDK
Session IP mismatchDisable Bind Session IP
Session expiredCall init again · check session TTL
HWID mismatchReset HWID in panel or wait cooldown

Panel Errors

ErrorFix
Panel 500 / JSON parse errorCheck config.production.php · DB credentials
allApps.map is not a functionHard refresh · update panel/assets/app.js
App not found (customer)URL missing owner+app · enable customer panel
403 on sdk/php/*.phpUse SDK portal viewer

Server Checks

  1. /health — db ok, sign ok, sign_public present
  2. PHP extensions: sodium, openssl, pdo_mysql
  3. Apache mod_rewrite enabled (.htaccess routes)
  4. Run /install/upgrade.php after updates

Get Help