diff --git a/.project b/.project
index ac328d6..e6758a5 100644
--- a/.project
+++ b/.project
@@ -34,4 +34,15 @@
 		<nature>org.eclipse.wst.common.project.facet.core.nature</nature>
 		<nature>org.eclipse.wst.jsdt.core.jsNature</nature>
 	</natures>
+	<filteredResources>
+		<filter>
+			<id>1708682957073</id>
+			<name></name>
+			<type>30</type>
+			<matcher>
+				<id>org.eclipse.core.resources.regexFilterMatcher</id>
+				<arguments>node_modules|\.git|__CREATED_BY_JAVA_LANGUAGE_SERVER__</arguments>
+			</matcher>
+		</filter>
+	</filteredResources>
 </projectDescription>
diff --git a/.vscode/launch.json b/.vscode/launch.json
new file mode 100644
index 0000000..b0bea0e
--- /dev/null
+++ b/.vscode/launch.json
@@ -0,0 +1,16 @@
+{
+    // Usare IntelliSense per informazioni sui possibili attributi.
+    // Al passaggio del mouse vengono visualizzate le descrizioni degli attributi esistenti.
+    // Per altre informazioni, visitare: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "type": "java",
+            "name": "Debug (Attach)",
+            "projectName": "identity-manager",
+            "request": "attach",
+            "hostName": "localhost",
+            "port": 5005  
+        }
+    ]
+}
\ No newline at end of file
diff --git a/README.md b/README.md
index c81679b..466fb13 100644
--- a/README.md
+++ b/README.md
@@ -13,6 +13,30 @@ HelloWorld service for smartgears4
 
 ## Documentation
 
+obtain {{TOKEN}} at  https://next.dev.d4science.org/group/gcube/home
+
+
+start the docker container
+```./buildImageAndStart.sh```
+
+test urls (replace {{TOKEN}} with your token):
+
+http://localhost:8080/helloworld/details?gcube-token={{TOKEN}}
+http://localhost:8080/helloworld/hello/details?gcube-token={{TOKEN}}
+
+http://localhost:8080/helloworld/auth?gcube-token={{TOKEN}} (checks for myRole role)
+http://localhost:8080/helloworld/auth/orm_member?gcube-token={{TOKEN}} (checks for OrganizationMember role)
+
+
+### DEBUG
+
+start the docker container in debug Mode
+```./buildImageAndStartWithDebug.sh```
+
+connect the JAVA debugger to port 5005
+
+* VSCODE: press the green play button and start "Debug (Attach)
+
 ## Change log
 
 See [Releases](https://code-repo.d4science.org/gCubeSystem/helloworld/releases).