How to reset the Iguana “admin” user password

Iguana stores passwords in a hashed format in the configuration file called ‘IguanaConfiguration.xml‘. These instructions explain how to reset the admin user password to “password”.

Note: To change passwords for other users, use Iguana Settings >  Change Password in Iguana Settings.

Tip: When Iguana is installed it automatically fills in the admin password in the logon screen. To change this behaviour simply change the admin password.

This behaviour has two purposes: Convenience by allowing you to logon with one click on a development server and security as it reminds you to change the admin password on a production server.

To reset your admin password

  1. Stop the Iguana Service:
    • On Windows use the “Administrative Tools > Services” to stop the iNTERFACEWARE Iguana service
    • On Mac OSX, Linux, or Unix you must stop the iguana_service daemon
  2. Make a backup copy of the IguanaConfiguration.xml file:
  3. Open the IguanaConfiguration.xml file in Notepad, or another text editor.
  4. Locate the entry for the admin user, which should look something like this:
          name="test group"/>
  5. Change the password attribute to the following:
    password="E3274BE5C857FB42AB72D786E281B4B8"This will reset the admin password to password”.
  6. Save your changes.
  7. Restart the Iguana service.
  8. Log onto Iguana as admin using a password of “password”.
  9. Change the admin password to something that follows your security guidelines.

Note: The Iguana admin user has full access to everything in Iguana. We recommend that you use a secure password, particularly for production systems.

Please contact support at if you need more help.

Leave A Comment?