diff --git a/README.md b/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..e335e0352150b62f3f63798d184d96e4c0305d02
--- /dev/null
+++ b/README.md
@@ -0,0 +1,13 @@
+# Conformance IdP deployment
+
+To easily run the conformance IdP, you can use docker compose:
+
+```shell
+cd docker
+docker compose up -d --build
+```
+
+This will start SimpleSAMLphp at `http://localhost/simplesaml/module.php/admin` with the conformance module installed,
+mariaDB database and nginx as a reverse proxy.
+
+You need to mount configuration and metadata folders, see `docker-compose.yml`, and add HTTPS (e.g. Let's encrypt).