How can I start Iguana in Safe mode?

Introduction

If you are having problems with one or more of your Iguana channels, you can start Iguana in safe mode. In safe mode, none of your channels are started automatically when Iguana is started.

Tip: If Iguana detects a problem within one minute of startup and does not shut down cleanly, it will automatically restart in safe mode. This enables you to ensure that the channels that you have configured to start automatically are not the cause of this problem.

Issue [top]

How to start Iguana in Safe mode.

Solution [top]

To start Iguana in safe mode, open a command prompt window on Windows or a terminal window on Linux or Mac OS X, change to the Iguana install directory, and run Iguana with the --safe_mode option.

Windows:

  1. Open a command prompt with administrator rights:

    You need to use the “Run as administator” option when you open the command prompt.

  2. Run these commands:

    Substitute your own install directory for C:\Program Files\iNTERFACEWARE-Iguana

    • Change to the install directory using this command: 
      cd C:\Program Files\iNTERFACEWARE\Iguana
    • Start Iguana in safe mode: 
      iguana --run --safe_mode

Mac/Linux:

  1. Open a terminal window.
  2. Run these commands:

    Substitute your own install directory for /Applications/iNTERFACEWARE-Iguana/

    • Change to the install directory using this command: 
      cd /Applications/iNTERFACEWARE-Iguana/
    • Start Iguana in safe mode: 
      sudo ./iguana --run --safe_mode