diff --git a/README.md b/README.md
index 957b06c..85cd37a 100644
--- a/README.md
+++ b/README.md
@@ -13,7 +13,8 @@ Installs gmux and gmuxd into a dev container. gmuxd starts automatically when th
   "image": "mcr.microsoft.com/devcontainers/base:debian",
   "features": {
     "ghcr.io/gmuxapp/features/gmux:1": {}
-  }
+  },
+  "forwardPorts": [8790]
 }
 ```
 
diff --git a/src/gmux/README.md b/src/gmux/README.md
index 244cc8d..539574c 100644
--- a/src/gmux/README.md
+++ b/src/gmux/README.md
@@ -9,11 +9,15 @@ Installs [gmux](https://gmux.app) and gmuxd into a dev container. gmuxd starts a
   "image": "mcr.microsoft.com/devcontainers/base:debian",
   "features": {
     "ghcr.io/gmuxapp/features/gmux:1": {}
+  },
+  "forwardPorts": [8790],
+  "portsAttributes": {
+    "8790": { "label": "gmux", "onAutoForward": "silent" }
   }
 }
 ```
 
-Port 8790 is automatically forwarded to the host. Open the forwarded URL and authenticate with the bearer token.
+Add `forwardPorts` to your `devcontainer.json` so port 8790 is forwarded to the host. Open the forwarded URL and authenticate with the bearer token.
 
 ### Finding the auth token
 
@@ -39,6 +43,7 @@ If you need a known token (for scripting, health checks, or future host-side pee
   "features": {
     "ghcr.io/gmuxapp/features/gmux:1": {}
   },
+  "forwardPorts": [8790],
   "containerEnv": {
     "GMUXD_TOKEN": "output-of-openssl-rand-hex-32"
   }
diff --git a/src/gmux/devcontainer-feature.json b/src/gmux/devcontainer-feature.json
index 05120cd..ebf7ecb 100644
--- a/src/gmux/devcontainer-feature.json
+++ b/src/gmux/devcontainer-feature.json
@@ -14,12 +14,5 @@
   "containerEnv": {
     "GMUXD_LISTEN": "0.0.0.0"
   },
-  "forwardPorts": [8790],
-  "portsAttributes": {
-    "8790": {
-      "label": "gmux",
-      "onAutoForward": "silent"
-    }
-  },
   "entrypoint": "/usr/local/bin/gmuxd-start.sh"
 }