Berlioz Documentation :: Berlioz Documentation

Welcome to Berlioz!

Berlioz is a service that delivers microservices applications to public cloud. Application components are defined in YAML using high level abstractions. This enables teams to work independently and focus on business problems rather than cloud logistics. Berlioz will also configure cloud native services like DynamoDB, Kinesis, PubSub, Storage, etc.

Another very useful capability of Berlioz is to deploy the application locally on a workstation as if it is running in an public cloud. This will also work even if the application is using cloud native resources and services. This significantly improves development team productivity.

Getting Started

Here you will find a 5-minute guide to try out Berlioz. This page assumes that you’re running on a development workstation with Docker, Git and Node.js installed. If not, refer to detailed installation guide here.

Step 1. Install Berlioz
$ npm install berlioz -g
Step 2. Download samples repository
$ git clone
Step 3. Deploy sample project
$ cd samples/01.HelloWorld.js/v5.db
$ berlioz local build-run

At step 3 you will see docker files identitifed, built and started locally. This command would also pull and start latest images for Jager, Prometheus and Grafana. Upon succesful execution you will see list of URLs to access the sample application and monitoring tools.

Step 4. Cleanup

It is considered a best practice to cleanup after yourself. A simple command would do just that.

$ berlioz local stop