Skip to main content

UNIX®, Linux, and macOS Development Installation

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

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

Development Installation Overview


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

  • The installation script, irisinstall, does the following:

    • Installs the InterSystems IRIS system manager databases.

    • Starts InterSystems IRIS in installation mode.

    • Installs InterSystems IRIS system manager globals and routines.

    • Shuts down InterSystems IRIS and restarts using the default configuration file (iris.cpf). Upgrade installations restart using their updated configuration files.


  • Standard InterSystems IRIS installation consists of a set of modular package scripts. The scripts conditionally prompt for information based on input to previous steps, your system environment, and whether or not you are upgrading an existing instance.

  • The first stage of the installation stores all gathered information about the install in a parameter file.

  • You then confirm the specifics of the installation before the actual install takes place.

  • The final phase performs the operations that are contingent upon a successful install, such as instance startup.

  • Development installations include the following component groups:

    • InterSystems IRIS Database Engine (including user database, Language Gateways, and Server Monitoring Tools)

    • InterSystems IRIS launcher

    • Studio

    • Database drivers

    • InterSystems IRIS Application Development (including language bindings)

    • Web Gateway


If the profile of the user executing irisinstall has a value set for the CDPATH variable, the installation fails.

Step 1: Choose Security Settings


  • You are prompted for initial security settings.

  • Input (2) to choose Normal security settings.


  • You can choose from the following initial security settings:

    • Minimal (1)

    • Normal (2)

    • Locked Down (3)

  • Minimal is only available for InterSystems IRIS installations. If you choose this, you can skip the next step; the installer sets the owner of the instance as root.

  • There are additional security settings that you can choose only through a custom install. See InterSystems IRIS Custom Installation for details.

  • See Initial InterSystems Security Settings for details on the different security settings and choosing one for your system.

Step 2: Define Instance Owner


  • If you selected Minimal or Locked Down in the previous step, you are prompted for additional information:

    • Instance owner — Enter the username of the account under which to run InterSystems IRIS processes. See Determining Owners and Groups for information about this account. Once InterSystems IRIS is installed, you cannot change the owner of the instance.

    • Password for the instance owner — Enter the password for username you entered at the previous prompt, and enter it again to confirm it. A privileged InterSystems IRIS user account is created for this user with the %All role.

      This password is used not only for the InterSystems IRIS privileged user account, but also for the _SYSTEM, Admin, and SuperUser predefined user accounts. For more details on these predefined users, see Predefined User Accounts.

    • Password for the CSPSystem predefined user.


  • The passwords must meet the criteria described in the Initial User Security Settings table. Passwords entered during this procedure cannot include space, tab, or backslash characters; the installer reject such passwords.

Step 3: Determine Group to Start or Stop the Instance


  • You are prompted which group should be allowed to start and stop InterSystems IRIS.

  • Only one group can have these privileges, and it must be a valid group on the machine.

  • Enter the name or group ID number of an existing group; InterSystems IRIS verifies that the group exists before proceeding.

  • See Determining Owners and Groups for more information.

Step 4: Install Unicode Support


Step 5: Configure Web Server


  • If a local web server is detected, you will be asked if you would like to use the web server to connect to your installation.

  • Enter y. This will allow the web server to be connected automatically.

    If you enter n, the web server will not be connected automatically and you will have to configure it manually after the installation finishes.


  • If a web server is not detected, you will be asked if you would like to abort. If you choose to continue the installation, you will have to configure your web server manually after the installation finishes.


InterSystems recommends using the Apache httpd web server because it can be automatically configured during the installation process. Make sure it is installed and running before beginning the installation process. In most cases, it is not necessary to manually configure the Apache web server.

Step 6: Activate License Key


  • If the script does not detect an iris.key file in the mgr directory of an existing instance when upgrading, you are prompted for a license key file.

  • If you specify a valid key, the license is automatically activated and the license key copied to the instance’s mgr directory during installation and no further activation procedure is required.

  • If you do not specify a license key, you can activate a license key following installation. See Activating a License Key for information about licenses, license keys and activation.

  • On macOS, you may receive a prompt regarding network connections for irisdb. If so, select Allow.

Step 7: Review Installation


  • Review your installation options and press enter to proceed with the installation. File copying does not begin until you answer Yes.

  • When the installation completes, you are directed to the appropriate URL for the Management Portal to manage your InterSystems IRIS system. See Using the Management Portal for more information.

  • Continue to Post-Installation Tasks.

FeedbackOpens in a new tab