diff --git a/docs/development_environment.mdx b/docs/development_environment.mdx
index 994e1f0d..ff1c41b7 100644
--- a/docs/development_environment.mdx
+++ b/docs/development_environment.mdx
@@ -125,4 +125,6 @@ After that you can run Home Assistant like this:
 hass -c config
 ```
 
+If you encounter a crash (`SIGKILL`) while running this command on *macOS*, it's probably about lack of Bluetooth permission. You can fix it by adding this permission for your Terminal app (System Preferences -> Security & Privacy -> Bluetooth).
+
 The Home Assistant configuration is stored in the `config` directory in your repository.