From bf5334fe29d7f85f581a92797a1f7178a18a8511 Mon Sep 17 00:00:00 2001
From: Wayne Heaney <42350981+wheaney@users.noreply.github.com>
Date: Thu, 12 Feb 2026 11:00:00 -0800
Subject: [PATCH] Updated Breezy KDE Distrobox setup (markdown)

---
 Breezy-KDE-Distrobox-setup.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/Breezy-KDE-Distrobox-setup.md b/Breezy-KDE-Distrobox-setup.md
index fa6347f..39b40d8 100644
--- a/Breezy-KDE-Distrobox-setup.md
+++ b/Breezy-KDE-Distrobox-setup.md
@@ -1,7 +1,8 @@
 The `breezy_kwin_setup` script offers support for Distrobox to allow immutable distros to run the necessary build steps. 
 
 To run with Distrobox:
-1. Have a container ready (e.g. `distrobox create` or `distrobox create --image ...` to use a specific image)
+1. Have a container ready (e.g. `distrobox create` or `distrobox create --image ...` to use a specific image).
+   * It's important to make sure that the image snapshot is running off the same package versions -- especially the same KWin version -- as your host OS.
 2. Enter the container (e.g. `distrobox enter my-distrobox`) and install the necessary dependencies. 
    * See the `print_missing_dependencies` messaging [in the setup script](https://github.com/wheaney/breezy-desktop/blob/main/bin/breezy_kwin_setup) for the latest package manager commands. Or just skip to the next step and you'll see them printed out when the build fails.
 3. Run the setup script with the container name set in the `BREEZY_DISTROBOX` environment variable (e.g. `BREEZY_DISTROBOX=my-distrobox ~/Downloads/breezy_kwin_setup`). If this succeeds, you'll be able to launch the Breezy Desktop app, and the effect will be ready the next time you log in.
\ No newline at end of file