b2bitsepam/fixicc-h2 repository overview

⁠Table of contents

• What is FIXICC H2?⁠
  • About this image⁠
• Getting this image⁠
• How to use FIXICC H2 image⁠
  • Getting a license⁠
  • Quickstart in standalone mode⁠
  • Configure⁠
  • Enable state persistence⁠
  • Enable SSL/TLS⁠
  • A complete example⁠
• Resources⁠
• Where to get help⁠

⁠What is FIXICC H2?

The FIX Integrated Control Center H2 (FIXICC H2®) is a new generation of configuration and monitoring solution for applications built using the FIXEdge® products. It acts as centralized configuration repository for FIXEdge servers, and provides Web UI for administrators.

⁠About this image

This image contains standalone FIXICC H2®⁠ administration server.

Application servers and monitoring utilities, such as FIXEdge®⁠, FIXEdge Java®⁠ and FIXEye®⁠, are distributed separately.

⁠Getting this image

The recommended way to get the FIXICC H2 Docker Image is to pull the prebuilt image from the Docker Hub Registry⁠.

$ docker pull b2bitsepam/fixicc-h2

To use a specific version, you can pull a versioned tag. You can view the list of available versions⁠ in the Docker Hub Registry.

$ docker pull b2bitsepam/fixicc-h2:[TAG]

⁠Using FIXICC H2 image

⁠Getting a license

FIXICC H2 does not require license key to run. However, to run FIXEdge / FIXEdge Java managed by H2 you will need a valid license file. You can obtain a trial license from [email protected]⁠.

⁠Quickstart

Since version 24Q1.2, FIXICC H2 comes with embedded database, so you can run it without external dependencies, as described below. For more robust production setups we recommend to use PostgreSQL database, as outlined in official documentation⁠.

⁠Using the Command Line

$ docker run \
 --name h2 \
 -p 8080:8080 \
 b2bitsepam/fixicc-h2

Then open http://localhost:8080/app⁠ in browser.

⁠Using Docker Compose

Use this template for docker-compose.yaml:

version: '3'

services:
  fixicc-h2:
    image: b2bitsepam/fixicc-h2:latest
    ports:
      - 8080:8080

Then run docker-compose up -d, and open http://localhost:8080/app⁠ in browser.

⁠Configure

FIXICC H2 consumes its own configuration from filesystem. A custom configuration can be mounted to /etc/fixicc-h2 folder.

⁠Step 1: Initialize your configuration folder with copy of default configs

$ docker run --rm --entrypoint "" -v $(pwd)/conf:/tmp/conf b2bitsepam/fixicc-h2 sh -c 'cp -r /etc/fixicc-h2/* /tmp/conf'

⁠Step 2: Customize your configuration

For more details please have a look at FIXICC H2 documentation⁠

⁠Step 3: Run your FIXICC H2 with custom configuration folder mounted

$ docker run \
 --name h2 \
 -v $(pwd)/conf:/etc/fixicc-h2/ \
 -p 8080:8080 \
 b2bitsepam/fixicc-h2

You can also do this with a minor change to the docker-compose.yaml file:

fixicc-h2:
  ...
  volumes:
    - './conf:/etc/fixicc-h2/'
  ...

⁠Enable state persistence

If you remove the container then previously configured server settings, including FIX sessions and business rules, will be lost. To avoid this loss of data, you should mount a volume that will persist even after the container is removed.

For persistence you should mount a directory at the /etc/fixicc-h2/hsqldb path.

$ docker run \
 --name h2 \
 -v $(pwd)/data:/etc/fixicc-h2/hsqldb \
 -p 8080:8080 \
 b2bitsepam/fixicc-h2

You can also do this with a minor change to the docker-compose.yaml file:

fixicc-h2:
  ...
  volumes:
    - './data:/etc/fixicc-h2/hsqldb'
  ...

Note, you can skip this step if you have already mounted /etc/fixicc-h2 with custom configs, as hsqldb by default will keep its state as subdirectory of configuration folder.

Alternatively, switch to external PostgreSQL database, as outlined in official documentation⁠

⁠Enable SSL/TLS

By default FIXICC H2 accepts unencrypted HTTP connections on port 8080. To enable SSL/TLS support you should provide TLS certificates and make configuration changes.

Follow guidance in FIXICC H2: HTTPS Support⁠.

⁠Resources

• EPAM-B2BITS FIXICC H2 product official page⁠
• EPAM-B2BITS FIXICC H2 product knowledge base⁠

⁠Where to get help

⁠Sales Information

Ph: +1-267-759-9000 ext 9⁠
Email: [email protected]⁠

⁠Technical Queries

For technical queries please contact [email protected]⁠

© B2BITS EPAM Systems Company 2000-2025.