diff --git a/stages/org.osbuild.ostree b/stages/org.osbuild.ostree
index 361b70d5..00e15b81 100755
--- a/stages/org.osbuild.ostree
+++ b/stages/org.osbuild.ostree
@@ -1,5 +1,8 @@
 #!/usr/bin/python3
 """
+WARNING: This stage is deprecated and shouldn't be used when defining new
+         pipelines. Please use the individual ostree.* stages instead.
+
 Initialize the sysroot and pull and deploy an OStree commit
 
 Initializes a clean ostree based system root, pulls the given `commit` and