Install Node.js

Download and install Node.js v10 from

Install Docker

Setup Docker from

Install Berlioz

$ sudo npm install berlioz -g --unsafe-perm

Install GraphViz

Required only on workstation to be able to generate application diagrams. Source:

$ brew install graphviz

If the above command requires XCode installation it can be achived using command below. Source:

$ xcode-select --install

For installation issues with MacOS Mojave check throubleshooting section below.


node-pre-gyp error installing berlioz

When installing berlioz command line tool you may encounter flowing error below. Simply adding –unsafe-perm flag resolves the error.

node-pre-gyp ERR! stack Error: Failed to execute '/usr/local/bin/node /usr/local/lib/node_modules/npm/node_modules/node-gyp/bin/node-gyp.js configure --fallback-to-build --library=static_library --module=/usr/local/lib/node_modules/berlioz/node_modules/grpc/src/node/extension_binary/node-v67-darwin-x64-unknown/grpc_node.node --module_name=grpc_node --module_path=/usr/local/lib/node_modules/berlioz/node_modules/grpc/src/node/extension_binary/node-v67-darwin-x64-unknown --napi_version=4 --node_abi_napi=napi --napi_build_version=0 --node_napi_label=node-v67' (1)

Graphviz installation on MacOS Mojave

There are current issues with Graphviz installation on MacOS Mojave. Check this thread for solution or workaround.