diff --git a/README.md b/README.md
index 1fd62cb..bdd6778 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,29 @@
-# website
+
+
+
+
+# Website
+
+## The www.offen.software website
+
+This repository contains the source code for the website.
+
+---
+
+### Developing the application
+
+The development setup requires `docker` and `docker compose` to be installed.
+
+After cloning the repository, you can build the containers and install dependencies using:
+
+```sh
+$ make setup
+```
+
+You can test your setup by starting the application:
+
+```sh
+$ make up
+```
+
+which should enable you to access the homepage at .