diff --git a/README.md b/README.md
index 15fe694f..6c4c48cf 100644
--- a/README.md
+++ b/README.md
@@ -22,6 +22,10 @@ SPDX-License-Identifier: Apache-2.0
 Use this SDK to add realtime video, audio and data features to your Node app. By connecting to <a href="https://livekit.io/">LiveKit</a> Cloud or a self-hosted server, you can quickly build applications such as multi-modal AI, live streaming, or video calls with just a few lines of code.
 <!--END_DESCRIPTION-->
 
+### Warning
+
+Avoid running this with hot reloads (ex. [bun's hot reload](https://bun.sh/guides/http/hot)). This is known to cause issues with WebRTC connectivity.
+
 ## Monorepo Navigation
 
 - **Packages**:
diff --git a/packages/livekit-rtc/README.md b/packages/livekit-rtc/README.md
index 4d3f4cae..bae29633 100644
--- a/packages/livekit-rtc/README.md
+++ b/packages/livekit-rtc/README.md
@@ -16,6 +16,9 @@ Use this SDK to add realtime video, audio and data features to your Node app. By
 >
 > We welcome and appreciate any feedback or contributions. You can create issues here or chat live with us in the #dev channel within the [LiveKit Community Slack](https://livekit.io/join-slack).
 
+### Warning
+
+Avoid running this with hot reloads (ex. [bun's hot reload](https://bun.sh/guides/http/hot)). This is known to cause issues with WebRTC connectivity.
 
 ## Using realtime SDK