diff --git a/README.md b/README.md
index 0cbfe05d9..223d04a6d 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,13 @@
 
 # mailcow: dockerized documentation
 
-
 This project aims to provide the mailcow: dockerized documention for the [mailcow: dockerized](https://github.com/mailcow/mailcow-dockerized) project.
 
 https://mailcow.github.io/mailcow-dockerized-docs
+
+To build it locally, you need the [Material theme for MkDocs](https://squidfunk.github.io/mkdocs-material/), [MkDocs](https://www.mkdocs.org/) itself and [Pygments](http://pygments.org/). To install these with [pip](https://pip.pypa.io/en/stable/) and get it up and running, fire up your terminal and enter
+
+```
+pip install mkdocs-material
+mkdocs serve
+```
\ No newline at end of file
diff --git a/docs/index.md b/docs/index.md
index 0b3e8a521..cd9cd9eda 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,4 +1,4 @@
- # 🐮 + 🐋 = 💕
+# 🐮 + 🐋 = 💕
 
 ## Help mailcow
 
@@ -41,7 +41,7 @@ You can find a demo at [demo.mailcow.email](https://demo.mailcow.email), use the
 
 The integrated **mailcow UI** allows administrative work on your mail server instance as well as separated domain administrator and mailbox user access:
 
-- DKIM and ARC support
+- [DKIM](http://dkim.org) and [ARC](http://arc-spec.org/) support
 - Black- and whitelists per domain and per user
 - Spam score management per-user (reject spam, mark spam, greylist)
 - Allow mailbox users to create temporary spam aliases
@@ -61,22 +61,22 @@ The integrated **mailcow UI** allows administrative work on your mail server ins
 mailcow: dockerized comes with multiple containers linked in one bridged network.
 Each container represents a single application.
 
-- Dovecot
-- ClamAV (optional)
-- Solr (optional)
-- Oletools via Olefy
-- Memcached
-- Redis
-- MySQL
-- Unbound (DNS resolver)
-- PHP-FPM
-- Postfix
-- ACME-Client
-- Nginx
-- Rspamd
-- SOGo
-- Netfilter (Fail2ban-like integration by @mkuron)
-- Watchdog (basic monitoring)
+- [Dovecot](https://www.dovecot.org/)
+- [ClamAV](https://www.clamav.net/) (optional)
+- [Solr](http://lucene.apache.org/solr/) (optional)
+- Oletools via [Olefy](https://github.com/HeinleinSupport/olefy)
+- [Memcached](https://www.memcached.org/)
+- [Redis](https://redis.io/)
+- MySQL (well, actually [MariaDB](https://mariadb.org/))
+- [Unbound](https://unbound.net/) (DNS resolver)
+- [PHP-FPM](https://secure.php.net/manual/install.fpm.php)
+- [Postfix](http://www.postfix.org/)
+- [ACME](https://letsencrypt.org/)-Client
+- [Nginx](https://nginx.org/)
+- [Rspamd](https://www.rspamd.com/)
+- [SOGo](https://sogo.nu/)
+- [Netfilter](https://www.netfilter.org/) (Fail2ban-like integration by [@mkuron](https://github.com/mkuron))
+- [Watchdog](https://linux.die.net/man/8/watchdog) (basic monitoring)
 
 **Docker volumes** to keep dynamic data - take care of them!