Skip to main content

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:

STEP 1: If you haven't already, install IguanaX normally and locate your iguana.exe file.

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

STEP 2: Create an iguana.ini file in the same directory as the iguana.exe file.

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:

STEP 3: Add in your instance directory and service details to iguana.ini and save the file

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

STEP 4: Install the IguanaX service

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.