diff --git a/Breezy-KDE-Distrobox-setup.md b/Breezy-KDE-Distrobox-setup.md
new file mode 100644
index 0000000..fa6347f
--- /dev/null
+++ b/Breezy-KDE-Distrobox-setup.md
@@ -0,0 +1,7 @@
+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)
+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