diff --git a/README.rst b/README.rst
index 7c910cde3..ea1d6b60c 100644
--- a/README.rst
+++ b/README.rst
@@ -110,6 +110,10 @@ To get started, first `install BuildStream by following the installation guide
 and then follow our tutorial in the
 `user guide <https://docs.buildstream.build/master/main_using.html>`_.
 
+  Running BuildStream on macOS or Windows may work under Docker Desktop, WSL,
+  or Podman Desktop, but we only test in CI under Linux. but is not officially
+  supported.
+
 We also recommend exploring some existing BuildStream projects:
 
 * https://gitlab.gnome.org/GNOME/gnome-build-meta/