From 052c5d70de7e47b0f705961f251fe8f644cdf9e8 Mon Sep 17 00:00:00 2001
From: Rahul Thakoor <rahul.thakoor@gmail.com>
Date: Mon, 12 Oct 2026 15:59:13 +0400
Subject: [PATCH] docs: Add version field to the migration compose example

Match the readme example.

Change-type: patch
Signed-off-by: rahul-thakoor <13220877+rahul-thakoor@users.noreply.github.com>
---
 docs/migrating-from-v2.md | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/docs/migrating-from-v2.md b/docs/migrating-from-v2.md
index b82fae0..31cd337 100644
--- a/docs/migrating-from-v2.md
+++ b/docs/migrating-from-v2.md
@@ -17,12 +17,14 @@ At minimum your compose file must:
 - set `XDG_RUNTIME_DIR` and `WAYLAND_DISPLAY` on the browser service.
 
 ```yaml
+version: '2.4'
+
 volumes:
-  display-socket:
+  display-socket:                    # Shared Wayland runtime directory
 
 services:
   display:
-    image: bh.cr/balenasolutions/display-<arch>   # <arch> is aarch64 or amd64; see https://github.com/balenasolutions/display
+    image: bh.cr/balenasolutions/display-<arch> # <arch> is aarch64 or amd64; see https://github.com/balenasolutions/display
     privileged: true
     volumes:
       - display-socket:/run
@@ -30,8 +32,8 @@ services:
       io.balena.features.dbus: '1'
 
   browser:
-    image: bh.cr/balenasolutions/browser-<device-type>
-    privileged: true
+    image: bh.cr/balenasolutions/browser-<device-type> # e.g. raspberrypi4-64, raspberrypi5, generic-amd64
+    privileged: true # required for sound (/dev/snd) and V4L2 video-decode (/dev/video*) device access
     depends_on:
       - display
     environment:
@@ -40,7 +42,7 @@ services:
     devices:
       - /dev/dri:/dev/dri
     ports:
-      - '5011:5011'
+      - '5011:5011' # management API
     volumes:
       - display-socket:/run
 ```