Initializing help system before first use

# Configuring Insight 5 on Linux

Certain settings used by Insight 5 can be changed by editing the appropriate files.
Configuration files for the Insight 5 Server and Worker can be found in two locations.

- Server - /etc/fico-xpress-insight-server/
- Worker - /etc/fico-xpress-insight-worker/

The files are detailed below.

File | Description
--- | ---
`application.properties` | Contains application-level properties such as the port to run the application on and logging configuration.
`application.properties.default` | This file should not be edited, but may be used to restore default configuration options. Important: Modifications to this file will be overwritten when Insight is updated.
`environment` | Contains service-level properties such as the ability to override the Java that the application should use.

## Updating the Server Settings

To update the Server settings, perform the following steps:

1. Locate the relevant file at `/etc/fico-xpress-insight-server/`
2. Un-comment any applicable property, set a value and save your changes
3. Restart the service using the following command:

       systemctl restart fico-xpress-insight-server

## Updating the Worker Settings

To update the Worker settings, perform the following steps:

1. Locate the relevant file at `/etc/fico-xpress-insight-worker/`.
2. Un-comment any applicable property, set a value and save your changes.
3. Restart the service using the following command:

       systemctl restart fico-xpress-insight-worker

## Configuring Execution Authentication

Xpress Insight 5 uses a certificate to authenticate job execution.

- An Insight 5 worker will only authenticate requests from a specific server.
- An Insight 5 Server will only execute jobs on trusted Workers.

If all Workers are installed on the same machine as the Server and have been installed after the Server, this authentication is automatically configured by the installer. If this is the case, the installer will output confirmation text, and no manual configuration is necessary.

If the Worker is not on the same machine or was installed before the Server, you will need to configure this trust by performing the following steps:

1. Navigate to the Insight 5 Server installation folder, then copy the execution certificate from the following location:

       /etc/fico-xpress-insight-server/insight-execution-jwt.cert

2. Navigate to the Insight 5 Worker installation folder, and paste the `insight-execution-jwt.cert` file to one of the two following locations. Use either :
   - the default location of `/etc/fico-xpress-insight-worker/insight-execution-jwt.cert`.
   - any custom location, then must be added in `/etc/fico-xpress-insight-worker/application.properties` under the `General` section
3. Restart the Insight Worker for the changes to take effect by opening a terminal window and using the following command:

       systemctl restart fico-xpress-insight-worker

Parent Topic Configuring Xpress Insight

© 2001-2026 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.