diff --git a/README.md b/README.md
index d32c9d2..efafadf 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,22 @@
-# osada_ynh
-Osada (lesser known Zot6) is a decentralised social networking supporing Mastodon, Pleroma, Pixelfed, PeerTube, Funkwhale, Zap, Friendica, Hubzilla, and many more.
+# Osada for Yunohost
+
+[![Integration level](https://dash.yunohost.org/integration/osada.svg)](https://ci-apps.yunohost.org/jenkins/job/osada%20%28Community%29/lastBuild/consoleFull)
+
+[![Install osada with YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=osada) <br><br>
+**Shipped version:** 1.4
+<br>
+## Osada
+[Osada](http://zotlabs.com/osada/) uses **Zot6 protocol** which is next version of **zot5 protocol** used by [Hubzilla](http://hubzilla.org). Osada has native support for the **ActivityPub protocol** (W3C standard) as well as the more advanced features. It can inter-operate with other social networking applications and projects in either of these spaces, including **Mastodon, Pleroma, Pixelfed, PeerTube, Funkwhale, Zap, Friendica, Hubzilla,** and many more. <br>
+
+<p align="center"><img src="http://zotlabs.com/osada/img/comment_on_posts.gif"></p>
+<br>
+
+**Osada** is a **social networking** platform specifically designed to be the glue that binds much of the **decentralised** web in a way that has not been **possible before**. It does this not by magic, but by **“speaking the language” of the various decentralised networks** and acting as a translator to pass information between them. Using Osada, you can seamlessly connect and share with your contacts whether they have an account on a Hubzilla server, a Mastodon server, or any of several popular platforms on the open web. 
+
+## Important points to know before installing Osada
+1. Osada needs a valid **certificate** for your **domain** before installing Osada. For eg. Lets Encrpypt can be installed from Yunohost admin planel.
+1. Osada will require a **root domain**. Eg. osada.domain.tld
+1. Osada is **Ldap** enabled.
+1. Osada is **multi-instance** app.
+
+