Follow this guide to setup Docker Compose to run Activiti Cloud on your local computer in Docker VM.
You will need to allocate at least 4 CPU cores and 8 Gb of RAM for your Docker VM machine.
Before you start, the following packages must be installed:
Install Docker-compose if you use Docker for Desktop.
Install GNU Make. For Linux and Mac it is usually installed already, for Windows use Chocolatey GNU Make to install Make.
Install Git Bash Terminal . For Linux and Maс it is usually pre-installed. If you use Docker for Desktop on Windows, use Chocolatey Git Install to install Git Bash Terminal.
Open Bash command line terminal and run these commands to clone https://github.com/Activiti/activiti-cloud-examples into your local environment:
git clone https://github.com/Activiti/activiti-cloud-examplescd activiti-cloud-examples/docker-compose
You need to edit
.env file to configure DOCKER_IP property based on your OS and Docker VM type.
Use your local computer IP address for Docker for Desktop on Linux, Mac or Windows
docker-machine ip command if you use Docker Toolbox
Don't use 127.0.0.1 or localhost
After starting Modeler, wait for the containers to start. You can check the status by running
make ps and
make logs command to make sure that the containers are ready.
To access modeler please open the url in your browser:
You will be redirected to keycloak where you have to use credentials modeler/password
You will need to use Postman to use Activiti Rest Apis
Start Postman and add to Postman collection Activiti v7 REST API.postman_collection.json located in https://github.com/Activiti/activiti-cloud-examples
Then at the top right choose manage environment then use your own ip in current value tab. Then use activiti as default environment. To start work execute getKeycloakToken hruser in Postman Keycloak collection. Then run startProcess in rb-my-app Postman collection.
To see and follow logs in your terminal
To see logs for one service only
Quickly ssh to service pod
Other available actions
Please be sure that you are located in docker-compose folder before running commands.
If something doesn't work with modeller first of all clear cookies or start in incognito window
If you are using nip.io address make sure that local firewall or company firewall doesn't block requiests