DecisionRules Server

Backend container for running DecisionRules in Docker and On-Premise environments.

Production Container

Introduction

The DecisionRules Server is the main backend application of the platform. It powers rule evaluation, management APIs, background processing, licensing, and communication with the client application.

Use this container when you deploy DecisionRules in Docker, Kubernetes, or other On-Premise environments. It exists to provide the core runtime and API layer behind the DecisionRules UI and integrations.

The server requires these supporting services:

• MongoDB for persistent data storage

• Redis Cache for caching and internal processing

• a valid license key or offline license

• network access to required DecisionRules services when using online licensing

Setup

Where to get it

You can download the latest production image from Docker Hub:

• DecisionRules Server on Docker Hub

Before you start

Before you run the server, make sure you have:

• a running MongoDB instance

• a running Redis instance

• a valid license key

• enough resources for your workload

See also:

• Server (required)

• Prerequisites

• Offline License

Minimal Requirements

• 1GB memory per worker thread

Application info

• Default port: 8080

• Port for preflight: 8081

How to run it

You can run the container directly with docker run or through docker compose.

Method 1: Run with docker run

Pull the latest image:

docker pull decisionrules/server

Run the container:

docker run -d \
  -p 8080:8080 \
  -p 8081:8081 \
  -e WORKERS_NUMBER=1 \
  -e REDIS_URL=YOUR_REDIS_URL \
  -e MONGO_DB_URI=YOUR_MONGODB_URL \
  -e CLIENT_URL=http://localhost:80/#/ \
  -e LICENSE_KEY=YOUR_LICENSE_KEY \
  -v license:/assets/lic/ \
  decisionrules/server

Method 2: Run with docker compose

Create a docker-compose.yml file:

version: "1.0"

services:
  server:
    image: decisionrules/server
    environment:
      - "REDIS_URL=YOUR_REDIS_URL"
      - "MONGO_DB_URI=YOUR_MONGO_URI"
      - "CLIENT_URL=YOUR_CLIENT_URL"
      - "LICENSE_KEY=YOUR_LICENSE_KEY"
    ports:
      - "8080:8080"
      - "8081:8081"
    volumes:
      - license:/assets/lic/:rw

volumes:
  license:
    driver: local

Start it with:

docker compose up

What to check after startup

The server must be reachable by the client application and other services that depend on it.

To verify that the server is running, open:

SERVER_URL/health-check

You should receive an HTTP 200 OK response.

Some environment variables are optional. For the full list, see Environment Variables.