diff --git a/README.md b/README.md
new file mode 100644
index 0000000..565c46b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,14 @@
+# klankschool's bardak configuration
+
+This repo encapsulated bardak as a submodule and contains
+extra configuration on how we run bardak.
+Namely, we run it in an rootless podman container
+managed by a systemd user service.
+
+To install and run:
+
+- clone this repo
+- `./build.sh`
+- `./enable-user-service.sh`
+- `systemctl --user start bardak`
+