diff --git a/README.md b/README.md
index d3e31a8..95dd205 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,15 @@
-# DELIVER_MAN
\ No newline at end of file
+# DELIVER_MAN
+
+## Docker
+
+Run client + server + database:
+
+```bash
+docker compose up --build
+```
+
+Open the client at `http://localhost:8080`.
+
+Notes:
+- The API is proxied through the client container to the server at `/api`.
+- The MariaDB schema/data is auto-initialized from `docker/init.sql` on first run.