Windows install instructions

Automatic Install

Note: When installing Iguana as a Production Server please follow the recommendations in the the Best Practice Production Deployment for Iguana article in our Deployment Guide section.

Warning: If you are installing Iguana on a Windows Server you will need to Disable IE ESC (enhanced IE browser security), as it prevents javascript from running which prevents you from registering/running Iguana.

  1. Download the latest Iguana release.
  2. Make sure you use an account with Administrator privileges.
  3. If you are upgrading:
    • As a precaution you should copy the Iguana configuration files.
      • vcs_repo.sqlite
      • IguanaConfiguration.xml
      • Note: This is a precautionary measure as the manual install does not include these files, so they will not be overwritten during the upgrade process. However it is wise to have copies in case of problems.
    • If you have changed the Iguana Service Name then you will need to copy the iguana_service.hdf file.
      Note: When you install multiple Iguana instances on one machine they must use different service names.

      Tip: If you you accidentally overwrite this file you can recover by editing it as per the instructions in the Installation FAQs “How to recover from overwriting your default Iguana install with a manual one”.

    • Optionally you can copy the log files, see how to backup and restore Iguana.

      Tip: The simplest way to copy the configuration (and log) files is to copy the complete Iguana install directory.

      If anything goes wrong just delete the (upgraded) original directory and revert to the (non-upgraded) copy.

  4. Run the installer and follow the instructions.
  5. If the install.log file cannot be found just create an identically named empty text file and re-run the installer.
  6. Run Iguana using the default url http://localhost:6543 (or the port you specified)
  7. Login using the defaults, user = admin and password = password
    • Note: For a production server you should change the password for security
  8. Register Iguana.
  9. If you upgraded Iguana you should refresh the browser cache, usually F5 is enough.
    • New User: Click the “Activate Free Trial button
    • Existing Customer: Click “Log In and Activate” This Instance

Upgrading Iguana


  • Check your system meets the basic requirements.
  • Do not use SMB file shares for Iguana’s log files. This includes Samba and Windows Network shares.



  • The automatic install includes Chameleon (useful to edit VMD files).
  • The automatic install only allows you to run a single instance of Iguana (use a manual install for multiple instances).

Leave A Comment?

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.