diff --git a/components/usermgmt/README.md b/components/usermgmt/README.md
new file mode 100644
index 0000000..1b09a84
--- /dev/null
+++ b/components/usermgmt/README.md
@@ -0,0 +1,22 @@
+# User management
+
+This module is responsible for manging users/groups/roles as well as being a frontend for the casbin internal service.
+All user/auth related requests go through here.
+
+
+## Development
+
+### Start kratos
+
+``` shell
+cd components/usermgmt/_kratos
+kratos serve -c kratos.yml
+```
+
+### Run usermgmt server
+
+``` shell
+cd components/usermgmt/_kratos
+go run main.go
+```
+