diff --git a/README.md b/README.md
index b605f27..f2e9a9b 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,7 @@
 # OpenKool
 
-[![](https://images.microbadger.com/badges/image/daniellerch/openkool:r46.svg)](https://microbadger.com/images/daniellerch/openkool:r46 "Get your own image badge on microbadger.com")
-[![](https://images.microbadger.com/badges/version/daniellerch/openkool:r46.svg)](https://microbadger.com/images/daniellerch/openkool:r46 "Get your own version badge on microbadger.com")
+[![](https://images.microbadger.com/badges/image/daniellerch/openkool:r47.svg)](https://microbadger.com/images/daniellerch/openkool:r47 "Get your own image badge on microbadger.com")
+[![](https://images.microbadger.com/badges/version/daniellerch/openkool:r47.svg)](https://microbadger.com/images/daniellerch/openkool:r47 "Get your own version badge on microbadger.com")
 
 This application is a dockerized version of kOOL form [churchtool.org](http://www.churchtool.org).
 
@@ -9,7 +9,7 @@ kOOL is the most advanced open source church organization software which is curr
 Unfortunately, kOOL is built on old software and never had a good architecture. Improving this, however, would result in thousands of merge conflicts for every new upstream version. That is why OpenKool just aims to keep kOOL operational for next the years until there are better alternatives available.
 
 ## Installation
-The recommended deployment option for OpenKool is to use Docker containers. An official image is available at [daniellerch/openkool:r46](https://hub.docker.com/r/daniellerch/openkool).
+The recommended deployment option for OpenKool is to use Docker containers. An official image is available at [daniellerch/openkool:r47](https://hub.docker.com/r/daniellerch/openkool).
 
 For a detailed installation guide please refer to the `docs` folder.
 
diff --git a/docs/assets/ko-config.php_r46_r47.png b/docs/assets/ko-config.php_r46_r47.png
new file mode 100644
index 0000000..dbcf325
Binary files /dev/null and b/docs/assets/ko-config.php_r46_r47.png differ
diff --git a/docs/docker-compose.yml b/docs/docker-compose.yml
index 55ccdd6..b544e02 100644
--- a/docs/docker-compose.yml
+++ b/docs/docker-compose.yml
@@ -2,13 +2,11 @@ version: '2'
 
 services:
   app:
-    image: daniellerch/openkool:r46
+    image: daniellerch/openkool:r47
     restart: unless-stopped
     volumes:
       - config:/var/www/html/config
       - my_images:/var/www/html/my_images
-      - webfolders:/var/www/html/webfolders
-      - .webfolders:/var/www/html/.webfolders
   db:
     image: mariadb:latest
     restart: unless-stopped
diff --git a/docs/upgrade-r45-to-r46.md b/docs/upgrade-r45-to-r46.md
index 52e9184..6973ff5 100644
--- a/docs/upgrade-r45-to-r46.md
+++ b/docs/upgrade-r45-to-r46.md
@@ -1,4 +1,4 @@
-# OpenKool upgrage instructions
+# OpenKool upgrade instructions
 
 ## Prerequisites
 - Dockerized OpenKool R45 installation
diff --git a/docs/upgrade-r46-to-r47.md b/docs/upgrade-r46-to-r47.md
new file mode 100644
index 0000000..306b37f
--- /dev/null
+++ b/docs/upgrade-r46-to-r47.md
@@ -0,0 +1,26 @@
+# OpenKool upgrade instructions
+
+## Prerequisites
+- Dockerized OpenKool R46 installation
+- Backup of config files (might get overridden)
+- MySQL database backup (no downgrade path)
+
+## Steps
+1. Change the image name in your compose file  
+`daniellerch/openkool:r46` > `daniellerch/openkool:r47`  
+and remove the `.webfolders` and `webfolders` volumes
+2. Pull image and restart  
+`docker-compose up -d`
+3. Run the setup script  
+A) `docker-compose exec app bash /var/www/html/install/setup.sh`  
+You reject overriding ko-config.php and other modified config files. After that you have to edit the file manually and merge the change (see screenshot).  
+`docker-compose exec app vi /var/www/html/config/ko-config.php`  
+![](assets/ko-config.php_r46_r47.png)  
+B) `docker-compose exec app bash /var/www/html/install/setup.sh --force`  
+The script will override your config files and you have to run the web installer again (see [install.md](install.md)).
+4. Call install/update.phpsh from your web root with parameter -p to show changes and with -a to update the database.  
+`docker-compose exec app bash`  
+`./install/update.phpsh -a`
+5. Stay in your container and run the update script
+`php kool_update_r46_r47.php`
+6. Your upgrade is finished. You may enable the two new modules `subscription` and `taxonomy` in `ko-config.php` now.