diff --git a/code-serverx/readme.md b/code-serverx/readme.md
index fd0d1ac..91aacf6 100644
--- a/code-serverx/readme.md
+++ b/code-serverx/readme.md
@@ -14,4 +14,20 @@ docker-compose up
 * node+npm v16
 * maven 3.9.4
 
+## Notes
+### Using BaseX
 
+The `basex/bin` folder is added to the path so the binaries `basex`, `basexclient` etc are available.
+An admin password needs to be set on first use.
+```
+ basex -cPASSWORD
+ ...
+```
+To start server...
+```
+basexserver -S
+```
+
+### Using docker from the vscode container
+
+The user running VScode (id=1000 by default) must be a member of the group `docker` on the host os.
\ No newline at end of file