diff --git a/README.md b/README.md
index 703778e0..8a627bd1 100644
--- a/README.md
+++ b/README.md
@@ -16,3 +16,10 @@ It's intended to show and test all yii features.
 [![Total Downloads](https://poser.pugx.org/yiisoft/yii-demo/downloads.png)](https://packagist.org/packages/yiisoft/yii-demo)
 [![Build Status](https://travis-ci.com/yiisoft/yii-demo.svg?branch=master)](https://travis-ci.com/yiisoft/yii-demo)
 
+## Console
+
+Console works out of the box and could be executed with `./vendor/bin/yii`.
+
+## Web application
+
+In order to run web application either built-in web server could be used by running `./vendor/bin/yii serve` or a real web server could be pointed to `/public/index.php`.