diff --git a/docs/development_environment.mdx b/docs/development_environment.mdx
index ff1c41b7..73e4b655 100644
--- a/docs/development_environment.mdx
+++ b/docs/development_environment.mdx
@@ -44,6 +44,12 @@ The devcontainer comes with some useful tasks to help you with development, you
 
 When a task is currently running (like `Preview` for the docs), it can be restarted by opening the command palette and selecting `Tasks: Restart Running Task`, then select the task you want to restart.
 
+### Debugging with Visual Studio Code
+
+If the Dev Container was set up correctly - it supports debugging by default, out-of-the-box. It provides the necessary debug configurations, so hitting F5 should launch Home Assistant. Any breakpoints put in the code should be triggered, and the debugger should stop. 
+
+It is also possible to debug a remote Home Assistance instance (e.g., productive instance) by following the procedure described [here](https://www.home-assistant.io/integrations/debugpy/).
+
 ## Manual Environment
 
 _You only need these instructions if you do not want to use devcontainers._