diff --git a/ntfy/README.md b/ntfy/README.md
index 4e5216b..5b04a3d 100644
--- a/ntfy/README.md
+++ b/ntfy/README.md
@@ -1,3 +1,23 @@
 ### ntfy
 
+Runs a self hosted ntfy service in kubernetes cluster.
+
+## Dependencies
+
+- [just](https://github.com/casey/just)
+- [kubectl](https://kubernetes.io/docs/tasks/tools/)
+- [k8s viz](https://github.com/mkimuram/k8sviz)
+
+## usage
+
+This service uses `just` cli to manage the deployment.
+
+```bash
+just
+# list individual recipes
+just -l
+```
+
+## viz
+
 ![ntfy](ntfy-k8s.png)