diff --git a/README.md b/README.md
index 1d1eeb0..581ad82 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,18 @@
-# user-changelog
\ No newline at end of file
+# user-changelog
+
+---
+
+## Java application to operate/manage User's DB
+
+---
+
+## How to run application
+1. Copy `application-local-t.properties` into `application-local.properties`
+2. Add environment variable `SPRING_PROFILES_ACTIVE=local`
+3. run maven
+---
+
+## Technology Stack
+- Liquibase
+- MySql
+