Initializing help system before first use

Deploying with Docker Compose

To deploy Xpress Insight or Xpress Workbench (or both) in local Docker containers, use Docker Compose and one of the provided YAML files.
Before starting this procedure, make sure you have installed Docker Desktop with Docker Compose V2, and that Docker is running. For more information, see the Docker documentation.
Docker Compose configuration files are provided in a GitHub repository. To deploy, you download the appropriate configuration files to your local file system and then run Docker Compose.
Note: Docker Compose automatically downloads Docker images for Xpress Insight and Xpress Workbench from Docker Hub. These images are intended to be used only in a multi-container deployment with Docker Compose and should not be deployed individually.
  1. In your browser, navigate to the GitHub repository at https://github.com/fico-xpress/insight-docker.
    Download the contents to your local file system.
  2. Decide which type of configuration you want to deploy.
    1. Choose a persistence type:
      • File system persistence creates and mounts a Docker volume called insight-local-filesystem_data, which the Insight server uses to store all persisted data.
      • MySQL database persistence deploys a MySQL database in an additional container, which mounts a Docker volume for the MySQL binary data.
      In either case, the Docker volumes used to store data persist even if you upgrade to a new version of Insight.
      Note: You cannot change a deployment from one persistence type to the other. To use a different persistence type, you must export your Insight data from within the application, and then import the data into a new deployment.
    2. Determine whether you need to configure support for Conda environments.
      At least one Conda environment is required if you are developing Insight apps using Python, Java, or R. (For more information about Conda environments, see Working with Conda Environments.)

      If you plan to develop models using Mosel only, you do not need Conda.

  3. In a terminal window, navigate to your local copy of the GitHub repository and then to the subdirectory corresponding to the configuration you want to use:
    • insight-local-filesystem: File system persistence (Mosel only)
    • insight-local-mysql: MySQL database persistence (Mosel only)
    • insight-local-conda-filesystem: File system persistence with Conda
    • insight-local-conda-mysql: MySQL database persistence with Conda
  4. Modify the configuration to customize it for your needs.
    For more information about the possible configuration changes, see Configuration and Administration.
    Tip: At a minimum, if you plan to deploy Xpress Workbench, you should configure the Workbench data directory.
  5. Run the following command: 
    docker compose up
    Alternatively, you can deploy the containers individually with the following command: 
    docker compose up service...
    where service... specifies the containers you want to deploy, separated by spaces. You can specify server, worker, or workbench.
    For example, if you want to deploy Insight, but not Workbench, you can use this command: 
    docker compose up server worker
    In the terminal window, you will see the interspersed log messages from all of the containers that are being started. To see the log messages organized by container, use the Containers view in Docker Desktop.
    Tip: When you first deploy, Docker Compose downloads dependencies and builds the Docker images with the latest available software. This happens only during the initial deployment; when you subsequently use Docker Compose to start the containers, these local images are reused by default.

    On some systems, security software might block access to the required repository. If this happens, you might need to disable your security software.

    You can also skip the image build and instead pull prebuilt images from Docker Hub. For more information, see Deploying with Prebuilt Images.

When the deployment has finished, you can verify the results by accessing the applications in your browser:
  • To access Xpress Insight, navigate to http://localhost:8080 and log in with the default credentials (username admin, password admin123).
  • To access Xpress Workbench, navigate to http://localhost:9595.
Note: If you have changed the configuration to use different ports, adjust these URLs accordingly. (For more information, see Changing Ports.)

After deployment, it is recommended that you change the default passwords used by the MySQL database. For more information, see Changing Database Passwords.

You should also rebuild the Docker images periodically in order to install the latest security patches. For more information, see Running a Security Update.

To shut down, press Ctrl+C in the terminal window or use the docker compose down command. To restart the containers, use docker compose up. You can also use Docker Desktop to start and stop containers (for more information, see the Docker Desktop documentation).

Covered Topics
Parent Topic Docker Deployment Guide

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