How to install Chameleon


This page shows you how to install Chameleon GUI on Windows and the Chameleon Runtime on Linux, and Mac.

There are three ways to install Chameleon on Windows:

  1. Use the Iguana installer to install Iguana on your Windows machine as it includes a copy of Chameleon.
  2. Use the Chameleon installer.
  3. Perform a manual Chameleon install.

The second and third options are usually used after a manual Iguana install on Windows – as it does not include Chameleon.

Note: Chameleon applications can be deployed on all Windows, Linux, and Mac – but the Chameleon GUI only runs on a Windows machine (or Windows VM).

If you have any questions please contact us at

Using the Windows installer [top]

  1. Download the latest Chameleon installer from our download site:
    1. Chameleon 6.1.3 installer download link

      This link is for the Iguana installer executable – you can can also download the 6.1.3 zipped executable if company security policies prevent executable downloads.

  2. Run the installer using administrator permissions and accept the default install settings.

    In 99% of cases the defaults will suffice – but you can change the install directory or choose not to install the HL7 Simulator and/or HL7 Listener.

  3. Register Chameleon:
    1. Run Chameleon by double clicking the desktop icon (or the executable where you installed it).
    2. The Registration Code screen appears, locate the Machine ID:
      Chameleon registration
    3. Follow the Register Chameleon steps – in the “How to renew your Chameleon Registration” FAQ.

Manual Windows install [top]

  1. Create an install directory.
  2. Download the latest Chameleon no-installer file from our download site:
    1. Chameleon 6.1.3 no-installer download link
  3. Extract the contents of this file, and move them into the folder into which you want to install the additional copy of Chameleon.
  4. To start this copy of Chameleon, double-click VMstudio.exe in the install directory.
  5. Follow the Register Chameleon steps – from the “Using the Windows installer” section above.

Install runtime on Linux or Mac [top]

Note: You must be using gcc compiler version 3.4 or above

    1. Download the latest Chameleon tar file from our download site:
      1. Linux: Chameleon 6.1.4 tar download link
      2. Mac: Chameleon 6.1.4 tar download link
    2. Unpack the tarball:
      1. Run the following command:
        tar -xvzf <latest-chameleon-version>.tar.gz

        For example:

        tar -xvzf chameleon_6_1_4_linux_centos7_x64.tar.gz
      2. The tarball unpacks the contents into a directory called chameleon.

        You can run Chameleon from any directory with suitable permissions so long as you set the system variables (below) to match – though we recommend keeping “chameleon” for the install directory name.

    3. Verify that the tar file unpacked correctly:
      1. Check the sub-directories in the install directory, for example:
        cd chameleon
        CHM  admin  bin  java  lib  python_lib
    4. Set the System Variables, for example:
      export CHM_PYTHON_LIB_PATH=/home/user/chameleon/python_lib
      export CHM_PATH=/home/user/chameleon
      export CHM_PLATFORM=makefile.linux
    5. Find the Machine ID:
      1. Change to the Chameleon install directory if necessary, for example:
        cd chameleon
      2. Run msgtransform –version to display the Machine ID and version number:
        ./bin/msgtransform --version
      3. Identify the Machine ID:
        chameleon machine id
    6. Login to your members account and activate a new Chameleon license – using the Machine ID from the previous step.
    7. Alternatively email support at with the Machine ID and request a registration code.
    8. Set the System Variables for the registration key and expiry date, for example:
      export CHM_REGKEY='[]^]^^^\KEAEM?'

Installing Multiple copies on Windows [top]

Note: You can run multiple independent copies of Chameleon on Windows, each copy will need a separate install directory and it’s own license.

  1. Create a separate install directory for the new copy of Chameleon.
  2. Follow the same steps as the Manual Windows install – using the separate install directory you just created.

More Information [top]


Leave A Comment?

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