MacOS

Install Node.js

Download and install Node.js v10 from https://nodejs.org/en/download/

Install Docker

Setup Docker from https://docs.docker.com/docker-for-mac/install/

Install Berlioz

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

Install GraphViz

Required only on workstation to be able to generate application diagrams. Source: http://www.graphviz.org/download/

$ brew install graphviz

If the above command requires XCode installation it can be achived using command below. Source: http://osxdaily.com/2014/02/12/install-command-line-tools-mac-os-x/

$ xcode-select --install

For installation issues with MacOS Mojave check throubleshooting section below.

Troubleshooting

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. https://stackoverflow.com/questions/43372723/how-to-open-dot-on-mac