---
url: /gst-manager-whmcs/uninstalling.md
description: >-
  How to deactivate or fully remove GST Manager — deactivation keeps your data,
  while full removal means manually dropping the mod_gst_* tables.
---

# Uninstalling

GST Manager supports both non-destructive deactivation and full data removal:

* **Deactivation (Reversible):** Pauses module operations and hooks while preserving database records.
* **Full Removal (Irreversible):** Involves dropping database tables and reverting theme templates.
* **Maintenance pausing:** Safely disable module actions without configuration loss.

## Deactivate (reversible)

To deactivate GST Manager:

1. Navigate to **Setup → Addon Modules**.
2. Locate **GST Manager** and click **Deactivate**.

WHMCS confirms with:

::: info Deactivation message
*"GST Manager Deactivated. Tables preserved."*
:::

Deactivation applies the following changes:

* **Hook de-registration:** Removes generated hook stubs; client-area bank displays cease rendering.
* **Database preservation:** Retains all configuration, historical logs, and report tables.
* **Lossless reactivation:** Reactivating the addon restores previous settings immediately.

## Remove all data (irreversible)

To completely purge all module data:

1. **Deactivate module:** Click **Deactivate** under **Setup → Addon Modules**.
2. **Drop database tables:** Use phpMyAdmin or MySQL CLI to drop all tables with the `mod_gst_*` prefix.

::: danger This cannot be undone
Dropping `mod_gst_*` tables permanently deletes all GST Manager configuration and stored report data. Back up your database before dropping tables.
:::

### External WHMCS artifacts

Two components reside directly within native WHMCS directories and must be removed manually:

* **WHMCS tax rules:** Delete created IGST (18%) and CGST (9%) + SGST (9%) rules under WHMCS Tax Rules.
* **Theme templates:** Remove or restore original `invoicepdf.tpl` and `invoicepdffooter.tpl` files in theme folders.

## Temporarily disable instead

For temporary troubleshooting or maintenance:

* Deactivate the module under **Setup → Addon Modules**.
* Core database tables and historical report data remain intact.
* Reactivate at any time to resume full functionality.

## Related pages

* [Installation](/gst-manager-whmcs/installation) — reactivate and re-run setup
* [Configuration](/gst-manager-whmcs/configuration) — tax rules, templates and settings
* [Licensing](/gst-manager-whmcs/licensing) — what an active license controls