Skip to main content

UNIX®, Linux, and macOS Client-only Installation

This page details the steps for attended client-only installations on UNIX®, Linux, and macOS.

Make sure you have completed the following before performing the steps on this page:

Client-only Installation Overview


  • A client installation installs only the components of InterSystems IRIS that are required on a client system.


  • Client installations include the following component groups:

    • InterSystems IRIS launcher

    • Studio

    • Database drivers

    • InterSystems IRIS Application Development (including language bindings)

Step 1: Log in


  • Log in as any user. You do not need to install as root.

  • The files from this install have the user and group permissions of the installing user.

Step 2: Run irisinstall_client


  • Start the installation by running the irisinstall_client script, located at the top level of the installation files:

    # /<install-files-dir>/irisinstall_client
  • <install-files-dir> is the location of the installation kit, typically the directory to which you extracted the kit.

Step 3: System Type


  • The installation script will attempt to automatically detect your system type and validate against the installation type on the distribution media.

  • If your system supports more than one type (for example, 32–bit and 64–bit) or if the install script cannot identify your system type, you are prompted with additional questions.

  • You may be asked for the “platform name” in the format of the string at the end of the installer kit name.


Step 4: Specify Installation Directory


  • At the Enter a destination directory for client components prompt, specify the installation directory.

  • If the directory you specify does not exist, it asks if you want to create it. The default answer is Yes.


  • Review Installation Directory for more important information about choosing an installation directory.

  • The InterSystems IRIS registry directory, /usr/local/etc/irissys, is always created along with the InterSystems IRIS installation directory.

Step 5: Complete Installation


  • After specifying the directory, the installation proceeds automatically. You should see Installation completed successfully.

  • Continue to Post-Installation Tasks.

FeedbackOpens in a new tab