Initializing help system before first use

Deploying with Docker Compose

To deploy Xpress Workbench in a local Docker container, use Docker Compose and 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 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.

To deploy using Docker Compose:

  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. 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, you should configure the Workbench data directory.
  3. If you plan to develop models using Mosel only, you do not need Conda. Docker Compose configuration files are provided with support for these options: workbench.yaml and workbench-conda.yaml, the latter including Conda support.
  4. Run the following command: 
    docker compose -f config-file.yaml up
    where config-file.yaml is the Docker Compose configuration file that you chose in the previous step.
    In the terminal window, you will see the log messages from the container that is 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 application in your browser. To access Xpress Workbench, navigate to http://localhost:9595.

If you have changed the configuration to use different ports, adjust these URLs accordingly. (For more information, see Changing Ports.)

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 command: 
docker compose -f config-file.yaml down
To restart the containers, use the command: 
docker compose -f config-file.yaml up
You can also use Docker Desktop to start and stop containers (for more information, see the Docker Desktop documentation).
Covered Topics
Parent Topic Container Deployment Guide

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