HuntBee Framework

Installation Guide

Install HuntBee Framework and HuntBee Suites safely using OpenCart 4, manual ZIP or FTP fallback.

RecommendedComponent 4.1.0Difficulty: Easy

Install the Framework using the normal OpenCart 4 workflow.

Fresh installation

OpenCart Admin → Extensions → Installer
Upload huntbee.ocmod.zip and click Install
Open Extensions → Extensions → choose Modules
Find HuntBee Framework and click Install
Open HuntBee Suite Manager
Why are there two steps?The two installation stages are intentional. The first stage copies the HuntBee extension files. The second stage runs the Framework setup inside OpenCart.

Installing a paid Suite

  1. Make sure HuntBee Framework is installed.
  2. Open HuntBee Suite Manager.
  3. Enter and verify your Suite licence, or use the supported offline activation workflow where applicable.
  4. Click Install for the Suite you purchased.
  5. Wait for the operation to finish and confirm the Suite appears in the HuntBee menu.

If the online package download is unavailable

Manual ZIP upload

After the Suite already has a local activation, you can use Upload Package Manually. The Framework validates the ZIP, deploys it and runs setup automatically. You do not need a second “Complete Setup” after a successful manual ZIP upload.

FTP / File Manager fallback

If you must copy extracted files yourself, copy package contents into extension/huntbee/ using the folder mapping below. Do not upload the extracted folders to the OpenCart root.

Inside packageDestination
admin/extension/huntbee/admin/
catalog/extension/huntbee/catalog/
system/extension/huntbee/system/
manifests/extension/huntbee/manifests/

After copying the files, return to Suite Manager and use Complete Setup.

“Update HuntBee Framework first”

If you see this message while installing/updating a Suite, update the Framework first. It is a compatibility guard for package-changing operations. It is not a message that your already-installed Suite is disabled.

After installation

  • Open the installed Suite Overview and confirm its master/status settings.
  • For SEO Suite, configure Structured Data with real business facts. For Tracking Suite, configure consent and your first provider.
  • Configure the Suite scheduler when you enable background/queued work.
  • Test the relevant storefront/admin workflow before live use.
  • Keep a normal store backup policy even though HuntBee package operations include safety checks.