diff --git a/database/README.md b/database/README.md
new file mode 100644
index 000000000..f78eca113
--- /dev/null
+++ b/database/README.md
@@ -0,0 +1,46 @@
+# database
+
+## Project setup
+```
+yarn install
+```
+
+## Upgrade migrations production
+```
+yarn up
+```
+
+## Upgrade migrations development
+```
+yarn dev_up
+```
+
+## Downgrade migrations production
+```
+yarn down
+```
+
+## Downgrade migrations development
+```
+yarn dev_down
+```
+
+
+## Reset DB
+```
+yarn dev_reset
+```
+
+## Seed DB
+```
+yarn seed
+```
+
+## Seeded Users
+
+| email                  | password   | admin   |
+| peter@lustig.de        | `Aa12345_` | `true`  |
+| bibi@bloxberg.de       | `Aa12345_` | `false` |
+| raeuber@hotzenplotz.de | `Aa12345_` | `false` |
+| bob@baumeister.de      | `Aa12345_` | `false` |
+