diff --git a/docs/developer-setup.rst b/docs/developer-setup.rst
--- a/docs/developer-setup.rst
+++ b/docs/developer-setup.rst
@@ -128,6 +128,12 @@
       use-deprecated=legacy-resolver
 
 
+Setup the databases
+-------------------
+
+The different databases for each subproject that requires one (like ``storage`` or ``scheduler``) should be setup through the ``swh db create`` or ``swh db init`` command. See their help for more information.
+
+
 Executing unit tests
 --------------------