Installing ImpulseMinio — step-by-step

Drop the archive into WHMCS, activate the addon, configure provider credentials, set up your first plan, and verify ImpulseMinio shows up on the ImpulseCore Overview tab.

Last updated 20 days ago

Installing ImpulseMinio — step-by-step

ImpulseMinio is a dependent module of ImpulseCore. Get Core installed and active first, then come back here.

Before you start

  • ImpulseCore 1.6.0+ installed and active. ImpulseMinio depends on it for project membership, hook dispatch, the cron runner, audit, and the Security & Maintenance pipeline.
  • WHMCS 8.4 or later on PHP 8.1+ (8.3 recommended).
  • ionCube Loader 13+ for your PHP version. The licensed-tier files are encoded.
  • Shell access to the WHMCS server.
  • An SSH key pair readable by the WHMCS PHP user — the module injects the public key into provisioned VPS and SSHes in as root.
  • A VPS provider account (Vultr, Hetzner Cloud, DigitalOcean, or Linode) with an API token that can create/destroy instances.
  • A DNS provider account (Cloudflare recommended; DigitalOcean / Vultr / Linode / Hetzner DNS / AWS Route 53 also supported).

1. Upload the files

Extract the release archive into your WHMCS root:

cd /path/to/whmcs unzip /tmp/impulseminio-4.3.x.zip

You should end up with modules/servers/impulseminio/ (server module), modules/addons/impulseminio_addon/ (admin UI), plus a handful of files in includes/hooks/ and crons/. Make sure the WHMCS web user can read everything. On Plesk that's the subscription owner; on cPanel it's the cPanel user; on a vanilla LAMP it's typically www-data.

2. Activate the addon

In WHMCS Admin:

  1. Open System Settings → Addon Modules.
  2. Find ImpulseMinio Settings in the list and click Activate.
  3. Set Access Control → Full Administrator (or whichever roles should see the addon).
  4. Click Save Changes.

Activation creates every mod_impulseminio_* table, seeds three example plans flagged "(Example — configure before selling)", registers WHMCS hooks, registers the module manifest with ImpulseCore, and auto-discovers the SecurityCollector / SecurityActuator classes so the Security & Maintenance pipeline lights up on the next Core cron tick.

3. Configure provider credentials

Open the addon (Addons → ImpulseMinio Settings). The Overview tab shows a one-time tier picker (Free vs Licensed) — pick one, then work through the First-Time Setup checklist:

  • WHMCS server IPs (so admin-proxy firewall rules are correct).
  • SSH key path + public key.
  • VPS provider API key.
  • DNS provider credentials.
  • At least one active MinIO server.
  • At least one configured (non-example) plan.

Each checklist item links straight to the right form.

4. Apply your license key (Licensed tier only)

Skip this if you're on the Free tier.

  1. Open Tools → License.
  2. Paste your key (starts with IMINIO-) and click Verify License.
  3. You should see a green Licensed badge with your registered domain and expiry.

Verification is cached for 1 hour with a 7-day grace period on licensing-server errors.

5. Verify on Core's Overview tab

Open Addons → ImpulseCore → Overview. You should see ImpulseMinio in the Modules registered table within seconds of activation, along with its version and manifest path. If it's missing, Core's manifest registration didn't fire — re-run Deactivate → Activate on ImpulseMinio.

Common installation issues

  • Class not found: ImpulseCore when activating ImpulseMinio. Core isn't installed or isn't active. Activate Core first; see Installing ImpulseCore.
  • Blank page after activating ImpulseMinio. ionCube Loader missing for your PHP version. Install it and restart PHP-FPM.
  • ImpulseMinio doesn't appear on Core's Overview tab. The manifest registration ran but the cron hasn't ticked yet, or the activate hook failed silently. Check Core's audit log for an entry from impulseminio at activation time.

Related