Create an iguana.ini file for custom installation

The iguana.ini file is intended for customers who need to customize their Iguana installation to configure a specific Working Directory and service details.

You can create your own iguana.ini file in a few steps:

To detect the file it must have the same filename as the executable and be in the same folder:

If you have an IguanaX service uninstall it before continuing:

  • Windows: "C:\Program Files\IguanaX\iguana.exe" --service uninstall

  • Linux: sudo ./iguana --service uninstall

  • NOTE: We strongly recommend having only one instance per iguana.exe file

Create an iguana.ini file in the same directory as the iguana.exe file. The paths and names must match:

The contents of the iguana.ini file should look something like this (with your own values):

[server] working_dir=C:\ProgramData\IguanaX\Webservices\ name=IguanaXWeb display_name=Iguana X Webservices description=Iguana instance for webservices

Install the service, Iguana will automatically check for an .ini file during the service install:

  • Windows: "C:\Program Files\IguanaX\iguana.exe" --service install

  • Linux: sudo ./iguana --service install

This is required for scenarios where you may need to embed Iguana into an install of your own software or Install multiple Iguanas on a single server.