diff --git a/README.md b/README.md
new file mode 100644
index 0000000000..ebc381f84d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,82 @@
+[![pypi][pypi]][pypi-url]
+[![builds][builds]][builds-url]
+[![coverage][cover]][cover-url]
+![python][python]
+![license][license]
+
+[pypi]: http://img.shields.io/pypi/v/mayan-edms.svg
+[pypi-url]: http://badge.fury.io/py/mayan-edms
+
+[builds]: https://gitlab.com/mayan-edms/mayan-edms/badges/master/build.svg
+[builds-url]: https://gitlab.com/mayan-edms/mayan-edms/pipelines
+
+[cover]: https://codecov.io/gitlab/mayan-edms/mayan-edms/coverage.svg?branch=master
+[cover-url]: https://codecov.io/gitlab/mayan-edms/mayan-edms?branch=master
+
+[python]: https://img.shields.io/pypi/pyversions/mayan-edms.svg
+[python-url]: https://img.shields.io/pypi/l/mayan-edms.svg?style=flat
+
+[license]: https://img.shields.io/pypi/l/mayan-edms.svg?style=flat
+[license-url]: https://img.shields.io/pypi/l/mayan-edms.svg?style=flat
+
+
+<div align="center">
+  <a href="http://www.mayan-edms.com">
+    <img width="200" heigth="200" src="https://gitlab.com/mayan-edms/mayan-edms/raw/master/docs/_static/mayan_logo.png">
+  </a>
+  <br>
+  <br>
+  <p>
+    Mayan EDMS is a document management system. Its main purpose is to store,
+    introspect, and categorize files, with a strong emphasis on preserving the
+    contextual and business information of documents. It can also OCR, preview,
+    label, sign, send, and receive thoses files. Other features of interest
+    are its workflow system, role based access control, and REST API.
+  <p>
+
+<p align="center">
+    <img src="https://gitlab.com/mayan-edms/mayan-edms/raw/master/docs/_static/overview.gif">
+</p>
+
+</div>
+
+<h2 align="center">Installation</h2>
+
+The installation procedure uses the <a href="https://www.docker.com">Docker container manager (docker.com)</a>. Make sure Docker is properly installed and working before attempting to install Mayan EDMS.
+
+Step 1- Initialize the installation
+
+```bash
+docker run --rm -v mayan_media:/var/lib/mayan \
+-v mayan_settings:/etc/mayan mayanedms/mayanedms mayan:init
+```
+
+Step 2- Deploy a container
+
+```bash
+docker run -d --name mayan-edms --restart=always -p 80:80 \
+-v mayan_media:/var/lib/mayan -v mayan_settings:/etc/mayan mayanedms/mayanedms
+```
+
+Step 3- Open a browser and go to http://localhost
+
+
+<h2 align="center">Important links</h2>
+
+<a href="http://www.mayan-edms.com">Homepage</a>
+
+<a href="https://www.youtube.com/channel/UCJOOXHP1MJ9lVA7d8ZTlHPw">Videos</a>
+
+<a href="http://mayan.readthedocs.io/en/stable/">Documentation</a>
+
+<a href="http://www.mayan-edms.com/providers/">Paid support</a>
+
+<a href="https://groups.google.com/forum/#!forum/mayan-edms">Community forum</a>
+
+<a href="http://mayan-edms.1003.x6.nabble.com/">Community forum archive</a>
+
+<a href="https://gitlab.com/mayan-edms/mayan-edms">Source code, issues, bugs</a>
+
+<a href="https://gitlab.com/mayan-edms/">Plug-ins, other related projects</a>
+
+<a href="https://www.transifex.com/rosarior/mayan-edms/">Translations</a>
diff --git a/README.rst b/README.rst
deleted file mode 100644
index 426c881519..0000000000
--- a/README.rst
+++ /dev/null
@@ -1,65 +0,0 @@
-|PyPI badge| |Build Status| |Coverage badge| |Documentation| |License badge| |Python version|
-
-|Logo|
-
-Description
------------
-
-Free Open Source Electronic Document Management System.
-
-`Website`_
-
-`Video demostration`_
-
-`Documentation`_
-
-`Translations`_
-
-`Mailing list (via Google Groups)`_
-
-|Animation|
-
-License
--------
-
-This project is open sourced under `Apache 2.0 License`_.
-
-Installation
-------------
-
-To install Mayan EDMS, simply do:
-
-.. code-block:: bash
-
-    $ virtualenv venv
-    $ source venv/bin/activate
-    (venv) $ pip install mayan-edms
-    (venv) $ mayan-edms.py initialsetup
-    (venv) $ mayan-edms.py runserver
-
-Point your browser to 127.0.0.1:8000 and use the automatically created admin
-account.
-
-
-.. _Website: http://www.mayan-edms.com
-.. _Video demostration: http://bit.ly/pADNXv
-.. _Documentation: http://readthedocs.org/docs/mayan/en/latest/
-.. _Translations: https://www.transifex.com/projects/p/mayan-edms/
-.. _Mailing list (via Google Groups): http://groups.google.com/group/mayan-edms
-.. _Apache 2.0 License: https://www.apache.org/licenses/LICENSE-2.0.txt
-
-.. |Build Status| image:: https://gitlab.com/mayan-edms/mayan-edms/badges/master/build.svg
-   :target: https://gitlab.com/mayan-edms/mayan-edms/commits/master
-.. |Logo| image:: https://gitlab.com/mayan-edms/mayan-edms/raw/master/docs/_static/mayan_logo.png
-.. |Animation| image:: https://gitlab.com/mayan-edms/mayan-edms/raw/master/docs/_static/overview.gif
-.. |PyPI badge| image:: http://img.shields.io/pypi/v/mayan-edms.svg?style=flat
-   :target: http://badge.fury.io/py/mayan-edms
-.. |License badge| image:: https://img.shields.io/pypi/l/mayan-edms.svg?style=flat
-.. |Analytics| image:: https://ga-beacon.appspot.com/UA-52965619-2/mayan-edms/readme?pixel
-.. |Coverage badge| image:: https://codecov.io/gitlab/mayan-edms/mayan-edms/coverage.svg?branch=master
-   :target: https://codecov.io/gitlab/mayan-edms/mayan-edms?branch=master
-.. |Documentation| image:: https://readthedocs.org/projects/mayan/badge/?version=latest
-   :target: http://mayan.readthedocs.io/en/latest
-.. |Python version| image:: https://img.shields.io/pypi/pyversions/mayan-edms.svg
-
-|Analytics|