IPFlow for WHMCS

Importing, Exporting & Migrating IP Data

This guide covers migrating data from legacy IPAM modules (including ModulesGarden IP Manager), importing new IP blocks via CSV or JSON, exporting reports to Excel/CSV, and viewing administrative audit logs in IPFlow.

1-Click Migration from ModulesGarden IP Manager

If you are migrating to IPFlow from ModulesGarden IP Manager, IPFlow includes an automated migration wizard that imports all your subnets, IP records, and customer assignments with zero downtime.

+-------------------------------------------------------------------------------+
|                       ModulesGarden IP Manager Migration                      |
+-------------------------------------------------------------------------------+
| Legacy Tables Detected : [ mg_ip_subnets, mg_ip_ips (v2.x Detected) ]         |
| Estimated Subnets      : 12 Pools                                             |
| Estimated IP Records   : 3,072 IP Addresses (428 Currently Assigned)          |
| ----------------------------------------------------------------------------- |
| [ Cancel ]                                         [ Execute 1-Click Migrate ]|
+-------------------------------------------------------------------------------+

Step-by-Step Migration Instructions:

  1. Navigate to Addons > IPFlow > Import & Export.
  2. Locate the ModulesGarden IP Manager Migration section.
  3. IPFlow will automatically inspect your WHMCS database and detect any existing ModulesGarden tables.
  4. Click Execute 1-Click Migrate.
  5. IPFlow will safely read all pools and IP assignments, create the corresponding IPFlow subnets, bind active customer hosting records (tblhosting.id), and preserve all custom notes and VLAN tags.
  6. Once complete, a success summary will display the number of migrated pools and assigned IPs.

[!TIP]
The migration runs purely as a read-and-import operation. Your existing ModulesGarden tables are not deleted or modified, allowing you to verify data with complete peace of mind.

Importing IP Pools via CSV or JSON

You can bulk-import existing spreadsheets of IP addresses or restore JSON backups directly into IPFlow.

1. Download the Sample CSV Template:

  1. Go to Addons > IPFlow > Import & Export.
  2. Click Download Sample CSV Template.
  3. Open the file in Microsoft Excel, Apple Numbers, or Google Sheets.

Supported CSV Format Structure:

IP Address,Pool Name,CIDR,Gateway,Status,Service ID,Client ID,Country Code,MAC Address,Datacenter,Tags
185.190.20.10,US-East Pool,185.190.20.0/24,185.190.20.1,assigned,104,12,US,52:54:00:12:34:56,Equinix-DC2,"Production, VIP"
185.190.20.11,US-East Pool,185.190.20.0/24,185.190.20.1,free,,,,DE,,Hetzner-FSN1,"cPanel"

2. Uploading Your File:

  1. In the Import IP Inventory section, click Choose File and select your .csv or .json file.
  2. Click Import File.
  3. IPFlow will validate the addresses, create any new subnets automatically, apply tags, and bind existing client services.

Exporting IP Reports to CSV / Excel

Exporting your IP inventory allows network engineers and billing teams to generate custom reports:

  1. Navigate to Addons > IPFlow > Import & Export.
  2. Choose your export format:
  3. Export CSV: Generates a standard comma-separated spreadsheet compatible with Excel and Google Sheets containing all subnets, hostnames, assigned customer names, client IDs, and release dates.
  4. Export JSON: Generates a full structured backup file suitable for backup archiving or moving to another WHMCS instance.

[!NOTE]
IPFlow automatically sanitizes all exported CSV spreadsheet cells against formula injection (CWE-1236), ensuring your spreadsheets are 100% safe to open on administrative workstations.

Viewing Administrative Audit Logs

IPFlow keeps an immutable, searchable audit trail of every IP change across your system:

+-------------------------------------------------------------------------------------------------------+
| Filter: [ All Actions v ] Search: [ 185.190... ] [ Filter ]                                           |
| ----------------------------------------------------------------------------------------------------- |
| Timestamp           | IP Address    | Action   | Performed By         | Details                       |
| 2026-08-20 14:02:10 | 185.190.20.15 | Allocate | Admin: John D. (#1)  | Assigned to Service #104      |
| 2026-08-20 13:45:00 | 185.190.20.88 | Release  | Daily Cron (System)  | Auto-reclaimed from Terminated|
| 2026-08-20 11:20:34 | 185.190.20.50 | Reserve  | RBL Scanner (System) | Quarantined: Spamhaus Listed  |
+-------------------------------------------------------------------------------------------------------+

Navigate to Addons > IPFlow > Audit Logs to review which admin assigned an IP, when an IP was returned to the pool, and why an address was quarantined.