diff --git a/README.md b/README.md
index ea257e4c26e6c9dd74063326e61bcd0aad202a99..3c9e546c8087ab3dccbd9e36eff9a1f89d9824fe 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,7 @@
 # kops-replication
+
+Replicates critical images for the running of the kubernetes and kubeflow services into `registry.cern.ch`.
+
+Images are replicated using an argo workflow accessible at `https://kops-workflows.cern.ch/workflows` under the namespace of `kops-replication-k8s` for the kubernetes service or `kops-replication-acc` for ATS.
+
+The workflow(s) will fail if the upstream images do not exist; CI verifies this on merge to master. To run locally: `./scripts/validate_images.sh values-k8s.yaml`.