diff --git a/README.md b/README.md
index 5fa3d2e..ba5f07a 100644
--- a/README.md
+++ b/README.md
@@ -4,8 +4,29 @@
 
 ## usage
 
+### dependencies
+- [docker](https://docs.docker.com/engine/installation/)
+- [docker-compose](https://docs.docker.com/compose/install/)
+
 ### installation
 
+Get code from repository:
+```
+git clone https://gitbucket.pgollor.de/git/docker/gitbucket.git
+cd gitbucket
+```
+
+Generate new passwords for your databse!!!
+```
+./generate_password.sh
+```
+
+Change the confoguration and start with:
+```
+docker-compose up -d
+```
+
+
 ### configuration
 Please use the configuration file `gitbucket.conf` for your personal changes.
 There are three configs for gitbucket:
diff --git a/generate_password.sh b/generate_password.sh
new file mode 100755
index 0000000..5a0c220
--- /dev/null
+++ b/generate_password.sh
@@ -0,0 +1,7 @@
+#!/bin/bash
+
+pw1=$(</dev/urandom tr -dc A-Za-z0-9 | head -c 28)
+pw2=$(</dev/urandom tr -dc A-Za-z0-9 | head -c 28)
+
+sed -i "/^GITBUCKET_DATABASE_ROOT/c\\\GITBUCKET_DATABASE_ROOT=${pw1}" gitbucket.conf
+sed -i "/^GITBUCKET_DATABASE_PASSWORD/c\\\GITBUCKET_DATABASE_PASSWORD=${pw2}" gitbucket.conf