Custom Installation - Windows and Linux

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.

Before you go through the custom install process, there are a few key ideas to understand (needs 10.1.91 or above):

Iguana runs as a single executable

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 Iguana X packaged? The Key Components

Using an iguana.ini file allows you to customize where the configuration data goes

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

Using Configuration Files we can specify configurations like web port and log directory

See Web Configuration File and Log Directory Configuration File.

Use iguana --service install to register the service

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

Once you understand these key concepts, head over to https://interfaceware.atlassian.net/wiki/spaces/IXB/pages/2721906808 to perform a custom Iguana X install in your environment.

At present IguanaX doesn’t have any licensing. So the above should be enough information to script out using IguanaX on platforms like Docker.