diff --git a/Middleware-read-only.md b/Middleware-read-only.md
new file mode 100644
index 0000000..355760c
--- /dev/null
+++ b/Middleware-read-only.md
@@ -0,0 +1,13 @@
+S3Proxy can prevent mutating operations like put object.  An example properties file:
+
+```
+s3proxy.endpoint=http://localhost:8081
+s3proxy.authorization=aws-v2
+s3proxy.identity=local-identity
+s3proxy.credential=local-credential
+s3proxy.read-only-blobstore=true
+
+jclouds.provider=transient
+jclouds.identity=remote-identity
+jclouds.credential=remote-credential
+```
\ No newline at end of file