Skip to main content

Mac OS X Installation

Installation Procedure:​

STEP 1: To install Iguana, go to the download link: https://install.interfaceware.com:8080/ and select Mac OS

STEP 2: Download the DMG file for the installer from our download link

  • Open the MacOS IguanaX DMG Installer file.

  • Drag and drop the IguanaX application icon into your Applications Folder.

    • It might be necessary to stop IguanaX if it is already installed and replace the old application icon. Don't worry this will be an upgrade - you won't lose your data and configurations from your existing install.

  • Double click on the IguanaX application icon

  • In the Mac menu bar (top right), click the IguanaX icon to reveal a dropdown menu:

    • Choose Start Iguana from the dropdown to start the IguanaX service.

  • Then choose Iguana Dashboard from the dropdown to open your browser to Iguana which is running as a launchd service.

  • Login to Iguana using the default username, admin and password. Please change these to something more secure as soon as you login.

This video shows a quick demonstration of installing Iguana X on a MacOS computer:

Need to install Git?​

Install Git using the Xcode command line tools.

You may not have GIT installed on Mac and get this warning:

Click OK and a page will open up directing you on how to install GIT on MacOS. Or use this link.

Troubleshooting Tips:​

Can't access localhost:7654?

Sometimes MacOS does not resolve the loopback IP address (127.0.0.1) to “localhost” as it should.

So, please try to enter this in your URL: http://127.0.0.1:7654 to access your IguanaX dashboard.

Help! I cannot see where Iguana opened!

First time users of Iguana often miss the subtle little icon for Iguana in their top menu status bar. Here's a garish picture to show you where it is!

For more tips see, Troubleshooting Mac OS X Installation.