diff --git a/README.md b/README.md
index e69de29..8273599 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,7 @@
+# yate-image - build an OCI image of yate
+
+There doesn't seem to be a published, official image of yate, so we build our own. We're using the fork https://github.com/eventphone/yate.
+
+There are currently no customizations.
+
+The image has yate installed in `/opt/yate`. There is no entrypoint or command, running the image will start a shell.