diff --git a/UPGRADE_GUIDE b/UPGRADE_GUIDE
new file mode 100644
index 0000000000000000000000000000000000000000..229521de52e1a77e03cf525ab68d78752496f9ca
--- /dev/null
+++ b/UPGRADE_GUIDE
@@ -0,0 +1,16 @@
+# Upgrade Guide
+
+# Pre-Release -> 1.0.1 
+
+In the pre-release version of Polaris, the paths for the Docker volumes were different; when upgrading, make sure that the path for the Postgres volume no longer includes "production".
+```
+    volumes:
+      - ./mongodb_data:/data/db
+     ...
+    volumes:
+      - ./db:/var/lib/mysql
+    ...
+    volumens:
+      - ./database_analytics/production:/var/lib/postgresql/data
+```
+Additionally, the schemas in Polaris have changed — the Rights Engine updates these automatically, but you may want to manually adjust the JSON schema. You can find guidance on this in the documentation: https://polaris.pages.rwth-aachen.de/rights-engine/provider_schema/#migrating-from-an-older-version-prior-to-101
\ No newline at end of file