diff --git a/caom2harvester/README.md b/caom2harvester/README.md
new file mode 100644
index 00000000..72773d1f
--- /dev/null
+++ b/caom2harvester/README.md
@@ -0,0 +1,11 @@
+# caom2harvester
+
+This is a CAOM metadata synchronisation tool that reads from a database or repository service and
+writes to a local database.
+
+## This code is OBSOLETE
+The supported replacement is [icewind](https://github.com/opencadc/caom2db/tree/master/icewind)
+
+A docker image available: `images.opencadc.org/caom2/icewind` (use harbor API to check for version tags)
+
+---