Skip to content

bpmn-server#

Project Status: Active - The project has reached a stable, usable state and is being actively developed.

Sample Web App#

This is a sample web application (running Node.js and Express.js) to allow you to visualize your workflow, it is inteded as a front-end for bpmn-server.

Please see bpmn-server for full documentation

Installation#

This package requires Node.js and an access to MongoDB () if you don't have MongoDB already installed you can create a free cloud account here


git clone https://github.com/bpmnServer/bpmn-web.git

npm install

npm run setup

Edit .env file to have MongoDB point to your server or free cloud account

# PORT # for express application
PORT=3000

#API_KEY is used for remote access
API_KEY=12345

# MongoDB Settings
MONGO_DB_URL=mongodb://0.0.0.0:27017/bpmn
#
... more settings

Run Setup one more time

npm run setup

To start server#

npm run start

Console will display:

bpmn-server WebApp.ts version 1.4.0
MongoDB URL mongodb://0.0.0.0:27017/bpmn
db connection open

App is running at http://localhost:3000 in development mode
  Press CTRL-C to stop

Use your browser to view the bpmn-server running

Docker installation#

To install MongoDB, bpmn-server and bpmn-web in on container

1. Create a folder#

2. create a docker-compose.yml as follows:#

version: "3.7"
name: bpmn-server
services:
 bpmn-web:
    image: ralphhanna/bpmn-web
    command: sh -c "
        npm run setup &&
        npm run start"
    ports:
      - 3000:3000
    volumes:
      - 'app:/app'      
    depends_on:
      - mongo      
 mongo:
   image: mongo
   ports:
     - 27017:27017
   volumes:
     - mongodb:/data/db
volumes:
  mongodb:
    driver: local
    driver_opts:
      type: 'none'
      o: 'bind'
      device: './mongodb_volume'    
  app:
    driver: local
    driver_opts:
      type: 'none'
      o: 'bind'
      device: './bpmn_server_volume'    

3. start the container docker compose up -d#

Command Line Interface#

bpmnServer provide some basic functionalities using CLI

npm run cli


server started..
Commands:
        q       to quit
        s       start process
        lo      list outstanding items
        li      list items
        l       list instances for a process
        di      display Instance information
        i       Invoke Task
        sgl     Signal Task
        msg     Message Task
        d       delete instnaces
        lm      List of Models
        lme     List of Models
        ck      Check locked instnaces
        re      Recover hung processes
        lu      List Users
        spw     Set User Password
        ?       repeat this list
Enter Command, q to quit, or ? to list commands
>

to update to latest release#

npm update bpmn-server