diff --git a/README.md b/README.md
index b4f6482..25ce166 100644
--- a/README.md
+++ b/README.md
@@ -42,6 +42,33 @@
 - `GITBUCKET_SSH_PORT`: ssh port to bind to
 
 
+### Update
+Update your gitbucket image in three steps.
+But first of all: **MAKE A BACKUP!!!**
+
+1. Commit your local changes. Changes in `gitbucket.conf` will be ignored!
+
+2. get the new image
+Shutdown and remove your images. This will not delete your mysql database volume.
+```
+docker-compose down
+```
+
+After that get the new image and start it:
+```
+docker-compose pull
+docker-compose up -d --remove-orphans
+```
+
+
+3. cleanup your docker environment
+This step is optional. Please do this only if you understand the next line.
+```
+docker rmi -f $(docker images -f "dangling=true" -q)
+```
+
+
+
 ### Plugins
 To use plugins download the plugin and move it into `data/plugins`.
 After that restart the gitbucket container with `docker-compose restart main-gitbucket`.