diff --git a/README.md b/README.md
index df0e7c00d72a2d3871410415465fd480e1564b63..428e2ad9e65b704d31aee4d328e3e2b8fd52b870 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,13 @@
 # Distributed version of the Spring PetClinic Sample Application built with Spring Cloud [![Build Status](https://travis-ci.org/spring-petclinic/spring-petclinic-microservices.svg?branch=master)](https://travis-ci.org/spring-petclinic/spring-petclinic-microservices/)
 
+## Starting services locally
+Every microservice is a Spring Boot application and can be started locally using IDE or `mvn spring-boot:run` command. Please note that supporting services (Config and Discovery Server) must be started before any other application (Clients, Vets, Visits and API).
+If everything goes well, you can access the following services at given location:
+* Discovery Server - http://localhost:8761
+* Config Server - http://localhost:8888
+* AngularJS frontend (API Gateway) - http://localhost:8080
+* Clients, Vets and Visits Services - random port, check Eureka Dashboard 
+
 ## Understanding the Spring Petclinic application with a few diagrams
 <a href="https://speakerdeck.com/michaelisvy/spring-petclinic-sample-application">See the presentation here</a>
 
@@ -48,9 +56,9 @@ File -> Import -> Maven -> Existing Maven project
 ## Client-side Architecture
 
 Compared to the [standard Petclinic based on JSP pages](https://github.com/spring-projects/spring-petclinic), 
-this SpringBoot AngularJS Petclinic is splitted in 2 modules - a client module and a server module:
+this ~~SpringBoot AngularJS Petclinic is splitted in 2 modules - a client module and a server module~~:
 * springboot-petclinic-client : static resources (images, fonts, style, angular JS code) packaged as a webjar.
-* springboot-petclinic-server : Spring MVC REST API and an index.html template
+* ~~springboot-petclinic-server : Spring MVC REST API and an index.html template~~
 
 
 ## Looking for something in particular?