diff --git a/CHANGES.rst b/CHANGES.rst
index dab9285f3bb958d658fc1012bd899516ad91324c..93d651e66de08f939ef11b55b36ca5f666f79509 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,8 @@ compatible.
 
 The Matrix specification has been moved to a seperate git repository.
 
+You will also need an updated syutil and config. See UPGRADES.rst.
+
 Homeserver:
  * Sign federation transactions.
  * Rename timestamp keys in PDUs.
diff --git a/UPGRADE.rst b/UPGRADE.rst
index 713fb9ae83780d8d7ee33858c414ad71670ad7f4..9746630dd7f4546497d16a439f95411d651ba613 100644
--- a/UPGRADE.rst
+++ b/UPGRADE.rst
@@ -1,3 +1,16 @@
+Upgrading to v0.4.0
+===================
+
+This release needs an updated syutil version. Run::
+
+    python setup.py develop
+
+You will also need to upgrade your configuration as the signing key format has
+changed. Run::
+
+    python -m synapse.app.homeserver --config-path <CONFIG_> --generate-config
+
+
 Upgrading to v0.3.0
 ===================