diff --git a/imageless-kubernetes/examples/kind-demo.mdx b/imageless-kubernetes/examples/kind-demo.mdx
index 1ea4708..7ba18c3 100644
--- a/imageless-kubernetes/examples/kind-demo.mdx
+++ b/imageless-kubernetes/examples/kind-demo.mdx
@@ -9,6 +9,19 @@ Kubernetes deployment, but you don't have to build a container image.
 To demonstrate this, we'll run a simple web server backed by Redis using two
 Flox environments.
 
+## Prerequisites
+
+Before you start, make sure you have:
+
+- [Flox installed](/install-flox/install)
+- A FloxHub login — run [`flox auth login`](/man/flox-auth)
+
+The example pulls its Flox environments from FloxHub, so the shim needs a
+FloxHub token. `just up` copies your token into a Kubernetes secret for you
+and stops with an error if you are not logged in. See
+[Configuration](/imageless-kubernetes/config) for how that secret is created
+and mounted.
+
 ## Running the example
 
 The entirety of this example can be run locally with the following commands:
diff --git a/imageless-kubernetes/install/troubleshooting.mdx b/imageless-kubernetes/install/troubleshooting.mdx
index 55cc1a5..463eef5 100644
--- a/imageless-kubernetes/install/troubleshooting.mdx
+++ b/imageless-kubernetes/install/troubleshooting.mdx
@@ -23,7 +23,7 @@ Verify the Flox runtime configuration is present in the active containerd config
 
 2. Check if `containerd config dump` has an `imports` section that might be loading other configuration files.
 
-3. Confirm the relevant sections exist in the output:
+3. Confirm the relevant sections exist in the output. The plugin id depends on your containerd config schema version — `io.containerd.grpc.v1.cri` for `version = 2` (shown below) and `io.containerd.cri.v1.runtime` for `version = 3` or `4`. See [Self-managed installation](/imageless-kubernetes/install/self-managed) for both forms.
 
     ```toml
     [plugins."io.containerd.grpc.v1.cri".containerd.runtimes.flox]