diff --git a/docs/guide/shell.md b/docs/guide/shell.md
index 1072314e..a30a3f01 100644
--- a/docs/guide/shell.md
+++ b/docs/guide/shell.md
@@ -25,3 +25,6 @@ services:
 ```
 
 :::
+
+> [!NOTE]
+> Shell access only works in Docker containers. This includes agents, remote, swarm and local mode. Support for Kubernetes is planned, but it is not yet available.