2 files changed, 16 insertions, 1 deletions
diff --git a/CHANGES.rst b/CHANGES.rst
index dab9285f3b..995718c3a4 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -3,7 +3,9 @@ Changes in synpase 0.4.0 (2014-10-17)
 This server includes changes to the federation protocol that is not backwards
 compatible.
 
-The Matrix specification has been moved to a seperate git repository.
+The Matrix specification has been moved to a separate git repository.
+
+You will also need an updated syutil and config. See UPGRADES.rst.
 
 Homeserver:
  * Sign federation transactions.
diff --git a/UPGRADE.rst b/UPGRADE.rst
index 713fb9ae83..99ce1a2d3d 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
 ===================