---
url: /gst-manager-acellemail/installation.md
description: >-
  Install GST Manager for AcelleMail — upload the plugin, then activate it,
  which applies the one-time core hook points for you. A short SSH fallback
  covers hardened hosts.
---

# Installation

Get GST Manager live in three steps: upload, activate (which auto-applies core hook points), and configure your company details.

**Prerequisites:** a server meeting the [Requirements](/gst-manager-acellemail/requirements) (especially the ionCube Loader).

## 1. Upload the plugin

**Admin → Plugins → Upload Plugin** → upload `relyweb-gstmanager-vX.Y.Z.zip`.

AcelleMail extracts the plugin to `storage/app/plugins/relyweb/gstmanager/` and lists it as inactive, ready to activate.

## 2. Activate the plugin

**Admin → Plugins → GST Manager → Activate.**

Activation handles the setup automatically:

* **Database migration:** creates tables and seeds defaults (**24 config keys and 38 Indian states**).
* **Tax settings:** mirrors your default GST rate into AcelleMail's tax settings for new orders.
* **Core hook points:** auto-applies the 4 extension points (GST invoice PDF, GSTIN field, export numbering, and tax on order totals).

::: tip Hardened hosts & SSH fallback
On standard (cPanel) hosts, the hook points apply automatically with no SSH. On hardened hosts where the web process cannot write core files, the **GST Manager dashboard displays a banner** with a one-line SSH command to complete the patch. See [Apply the core hook points](/gst-manager-acellemail/guides/apply-core-patches).
:::

## 3. License and configure

1. **GST Manager → Plugin Settings → License** → enter and activate your license key. (Until the license is **Active**, the dashboard, Setup and Reports stay locked.)
2. Open **Setup** to configure company details: GSTIN, registered state, tax rate, invoice identity, and bank details.

See the [Configuration guide](/gst-manager-acellemail/configuration) for a walkthrough of every field.

## 4. Verify

* Confirm the **GSTIN field** appears on customer contact pages.
* Download an invoice to verify the **GST Tax Invoice PDF** renders.

## Related pages

* [Requirements](/gst-manager-acellemail/requirements)
* [Apply the core hook points](/gst-manager-acellemail/guides/apply-core-patches)
* [Configuration](/gst-manager-acellemail/configuration)
* [Licensing](/gst-manager-acellemail/licensing)