Fix: ImpulseMinio license validation fails

ImpulseMinio shows a license-invalid banner, replaces the admin tab with a "license check failed" notice, or refuses to activate licensed features.

Last updated 20 days ago

Fix: ImpulseMinio license validation fails

What you're seeing

  • The ImpulseMinio admin tab shows a red banner: License check failed.
  • Tools and Tools then License rejects your key with an error.
  • The Replication / Custom Domains / Multi-region tabs stay locked even though you have a valid license.
  • After moving the WHMCS install, ImpulseMinio refuses to validate at all.

Why it happens

ImpulseMinio's license check pairs your key against three things the licensing server has on file:

  • The key prefix — IMINIO- for production, IMDEV- for the dev companion.
  • The IP address the verify call originated from.
  • The install domain captured from WHMCS tblconfiguration.SystemURL.

The install domain is auto-captured on the first successful validation. After that, validation from a different domain is rejected. Migrations between hosts are the most common trigger.

Fix

  1. Look up the exact error. ImpulseCore's audit log filtered to module=impulseminio and event LIKE '%license%' has the verbatim response from the licensing server. The error message tells you which check failed:
    • Invalid — key revoked or doesn't exist.
    • Suspended — payment lapsed.
    • Expired — subscription ended past the grace period.
    • Invalid IP / Domain — IP or SystemURL no longer matches what's on file.
  2. For a domain mismatch after a WHMCS migration, the domain was auto-captured on the old install. You need to move the license to the new domain. From the licensing portal at impulsehosting.com/clientarea, find the license row and use the Reissue / Move action. Enter the new domain. Then back in the addon, open Tools and Tools then License and click Verify License Now — the cached failure clears.
  3. For a wrong-key prefix, confirm you pasted the right one. IMINIO- is the production prefix; IMDEV- is the dev-companion key and only works against the dev WHMCS install. Mixing them up shows a "key not found" error.
  4. For a transient network failure, the module honours its last successful validation for a 7-day grace window, so transient errors don't break customer-facing features. If you're inside the grace window and just want to clear the banner, the cron-driven re-check on the next tick resolves itself once your network reaches the licensing server.
  5. For "Suspended" or "Expired", renew the subscription at impulsehosting.com/clientarea. After payment posts, re-verify in the addon.

How to confirm it worked

The license badge in the tab strip flips from grey or red back to blue Licensed. The locked tabs unlock. The audit log records a fresh license.validated event with the current timestamp. Customers don't see anything change — license state is operator-only.

Still stuck?

Copy the verbatim error from the audit log row and open a thread on the community feedback board at feedback.impulsesoftware.com. Include the key prefix (not the full key), your WHMCS SystemURL, and the originating IP if you know it.

Related