Custom Installation

Custom installation requires Iguana version 10.1.91 or above.

There may be instances where you need to customize your Iguana installation, for example:

You need to install multiple Iguana instances on a single server;
You want to embed Iguana within an install of your own application; or
You simply want to change the location of your log directory.

There are a few key ideas to understand and implement depending on your customization needs:

Under windows and linux Iguana ships as a single executable. It has all its resources for HTML, Javascript etc. all built into one executable.

In fact for windows the ‘installer’ that you see is really just the Iguana executable running in a different mode. By renaming the file to be iguana_setup.exe and running it, it will run in its installer mode.

Updating Iguana is very straightforward because of this architecture.

See How is IguanaX packaged?

See Create an iguana.ini file for custom installation for setting your Iguana instance directory (working directory) and service details.

You’ll need to have started the service at least once before making any configuration changes to Iguana.

See Web Configuration File and Change the Log Directory.

This will work as a systemd service for Linux and as a windows service for windows.

IguanaX Documentation

Custom Installation

Related content