diff --git a/docs/development.md b/docs/development.md
index 46463f187..24496b5b0 100644
--- a/docs/development.md
+++ b/docs/development.md
@@ -106,3 +106,12 @@ pnpm debug:break
 ```
 
 > requires `pnpm build` previously
+
+
+#### debug internal output
+
+Each verdaccio module uses `debug`, use the namespaces in combination with filters to get a verbose output about each action, for example:
+
+```
+DEBUG=verdaccio:* pnpm start
+```