diff --git a/docs/how-it-works/sandboxes/overview.mdx b/docs/how-it-works/sandboxes/overview.mdx index 2094a7280e..cb346f7923 100644 --- a/docs/how-it-works/sandboxes/overview.mdx +++ b/docs/how-it-works/sandboxes/overview.mdx @@ -777,6 +777,14 @@ openshell forward start 8000 my-sandbox -d # run in background ``` OpenShell prints the local URL only after the forward listener is reachable. Background forwards must be tracked locally so `openshell forward list` and `openshell forward stop` can manage them. + +To bind the local side to an IPv6 loopback address, pass it positionally as `[bind_address:]port`. IPv6 addresses are bracketed in both the SSH forward argument and the printed access URL: + +```shell +openshell forward start ::1:8000 my-sandbox +# Local URL: http://[::1]:8000/ +``` + CLI forwards run independently of SSH multiplexing settings in your SSH config. Foreground forwards end when the command exits; only background forwards appear in `forward list`.