Skip to main content
Docker Compose provides the simplest way to run GoRules BRMS with a PostgreSQL database.

Prerequisites

  • Docker installed
  • Docker Compose v2+

Quick start

Create a docker-compose.yml file:
Start the services:
Access BRMS at http://localhost:9080.

Scaling

For multiple BRMS instances:
Use with a load balancer or Docker Swarm for production scaling.

Backup

Backup the PostgreSQL volume:

Upgrade

Update to the latest version:
The BRMS automatically runs database migrations on startup.

Troubleshooting

Container won’t start

Check logs:
Common issues:
  • Invalid LICENSE_KEY
  • Database connection failed
  • Missing required environment variables

Database connection errors

Verify PostgreSQL is healthy:

Reset everything

Remove all data and start fresh:
This deletes all data including the PostgreSQL volume.