Initializing help system before first use

Production and Development Environments

FICO® Xpress Insight can run in one of two configurations: Development mode or Production mode.
When initially installed, Xpress Insight defaults to operate in Development mode.
  • Development mode allows local accounts and can be used for non-production environments, such as development and QA, and while evaluating Xpress Insight. IdP (Identity Provider) integration is available in development mode using SAML 2.0.
  • Production mode should be used for operational installations. When this mode is enabled, SAML authentication is required and local accounts are disabled. All user administration functions are handled by the IdP.

Production Mode

Before you enable Production Mode:
  • The Insight Server must be configured to use https. For more, see Securing Xpress Insight 5.
  • SAML 2.0 must be enabled.
  • MySQL persistence must be enabled before Production Mode can be enabled.
Note: Putting the Server into Production mode or enabling SSO will deactivate Local Authentication.

Enabling Production Mode

Xpress Insight 5 uses an application.properties file to manage some application settings and register the location of certain files. For more on the application properties file, see the Xpress Insight Administration Guide.
Note: This file is located in the appropriate <SERVER_CONFIG_DIR> for your OS. For more on <SERVER_CONFIG_DIR>, see Important Note about this Guide.

There is also the option to change the text displayed on the Xpress Insight application banner. By default, this label is set to Development when first installed, but will be blank if you enable Production mode. Editing this label value can help users differentiate between multiple environments.

To Enable Production mode:

  1. Navigate to and open the application.properties file in a suitable text editor.
  2. Locate the following line:
    insight.server.system.environment.type=development
  3. Edit the line to read as follows:
    insight.server.system.environment.type=production
  4. To edit the Xpress Insight banner label, edit the following line:
    insight.server.system.environment.label=<My New Environment Name>
  5. Select and configure your Data Storage method:
    • Use the native File System of your operating system for data storage: The supporting data files for the program are installed in C:\ProgramData\FICO\XpressInsight. The windows operating system hides this folder by default. Also, this location may be controlled by your IT department that may specify a different folder for program data.
    • The full release will allow using an installed copy of MySQL v8.x with vendor support or above for data storage.
  6. Configure User Authentication. For more, see Authentication using an Identity Provider (IdP).
  7. Enable the Admin user. At least one user must be granted Xpress Insight Admin rights in the IdP. Any user who requires access to all authority groups must be given the superuser attribute. For more on Authority Groups, see Managing Authority Groups.

Development Mode

Xpress Insight defaults to Development mode on installation. Development mode allows you to have either local user accounts or you can enable SSO to manage your user administration. Enabling SSO in Development mode will disable Local Authorization.

If you are deploying a local copy of Xpress Insight in Development mode, complete the following steps:
  1. Select and configure your Data Storage method:
    • Use the native File System of your operating system for data storage: The supporting data files for the program are installed in C:\ProgramData\FICO\XpressInsight. The Windows operating system hides this folder by default. Also, this folder may be controlled by your IT department that may specify a different folder for program data.
    • You can also configure an installed copy of MySQL v8.x with vendor support or above for data storage.
  2. Select your user authentication method:

© 2001-2025 Fair Isaac Corporation. All rights reserved. This documentation is the property of Fair Isaac Corporation (“FICO”). Receipt or possession of this documentation does not convey rights to disclose, reproduce, make derivative works, use, or allow others to use it except solely for internal evaluation purposes to determine whether to purchase a license to the software described in this documentation, or as otherwise set forth in a written software license agreement between you and FICO (or a FICO affiliate). Use of this documentation and the software described in it must conform strictly to the foregoing permitted uses, and no other use is permitted.