---
url: /gst-manager-whmcs/requirements.md
description: >-
  What your server and WHMCS install need before you run GST Manager — PHP,
  WHMCS, the ionCube Loader, PHP extensions, an active license and an Indian
  WHMCS store, with how to check each one.
---

# Requirements

Verify server compatibility before installing GST Manager:

* **Core runtime:** Compatible with PHP 8.2 through PHP 8.5 on WHMCS 8.13+ or 9.x.
* **Loader requirement:** Requires ionCube Loader 13.0.2 or newer.
* **Administrative role:** Requires Full Administrator permissions for addon access.
* **Market scope:** Built for WHMCS instances invoicing Indian and cross-border clients.

## Server and software

| Requirement | Details |
| --- | --- |
| **PHP** | 8.2 or newer (runs on 8.2, 8.3, 8.4 and 8.5) |
| **WHMCS** | 8.13 or newer, or 9.x |
| **Admin access** | A **Full Administrator** account; the addon must be granted access to your admin role |
| **ionCube Loader** | 13.0.2 or newer (see below) |
| **PHP extensions** | `curl`, `openssl`, `json`, `zip`, `mbstring` |
| **License** | An active GST Manager license |
| **Store** | A WHMCS store selling to Indian customers |

## The ionCube Loader

GST Manager is distributed as an ionCube-encoded package:

* **Extension dependency:** Requires the standard ionCube Loader PHP extension.
* **Version baseline:** Needs **ionCube Loader 13.0.2+** for PHP 8.2, **14.4.0+** for PHP 8.3, or **15.x**.
* **Universal compatibility:** A single build operates across all supported PHP and loader versions.

::: danger GST Manager will not run without ionCube
If the loader is missing or too old, GST Manager's encoded pages can't run — they show `ionCube Loader required. Contact support@relyweb.co`. Ask your host to enable **ionCube Loader 13.0.2 or newer** for your PHP version, then reload.
:::

## Why an Indian store

GST Manager is engineered specifically for Indian taxation compliance:

* **Tax splitting:** Automatically computes IGST vs CGST/SGST.
* **Invoice branding:** Stamps company **GSTIN**, SAC codes, and corporate PAN.
* **Statutory returns:** Exports clean GSTR-1 and FEMA CSV reports.

## Why Full Administrator access

WHMCS regulates addon modules through role-based access control:

* **Permission setup:** Grant **Full Administrator** role during module activation.
* **Access issues:** Without assigned roles, module navigation displays **Access Denied** or blank screens.
* **Management:** Adjust permissions under **Configuration → System Settings → Administrator Roles**.

## Why a license

* **Activation:** Unlocks full module operations and the Setup Wizard.
* **Client-area display:** Governs the license-gated customer invoice bank-details block.
* **Configuration:** Manage keys under **Addons → GST Manager → Global Settings → License**. See [Licensing](/gst-manager-whmcs/licensing).

## How to check

Verify server prerequisites directly inside WHMCS:

* **PHP & Extensions:** Check **Utilities → System → PHP Info** for PHP 8.2+ and required extensions (`curl`, `openssl`, `json`, `zip`, `mbstring`).
* **ionCube Loader:** Confirm the ionCube extension block and version on the same **PHP Info** screen.
* **WHMCS Version:** Verify installed version in the admin footer or under **Help → System Health Status**.

::: tip Ready to install?
Once your server checks out, head to [Installation](/gst-manager-whmcs/installation) to upload, activate and license GST Manager.
:::