diff --git a/README.md b/README.md
index 563364d..bbb87a9 100644
--- a/README.md
+++ b/README.md
@@ -49,8 +49,28 @@ However:
 
 [khatru](https://github.com/fiatjaf/khatru)
 
+## Git branches
+
+Use the branch `latest`.
+
+Do not run off of the `master` branch. Master is updated with breaking changes that are
+not only unstable, but which may require you to update your configuration. I will not
+announce upgrade instructions until release.
+
 ## Change Log
 
+### Version 1.4.0 (2024-05-07, 25058ef4)
+
+- Origin header logged
+- CLOSED: auth-required sent if DMs requested and not authenticated yet
+- config: minimum_ban_seconds, timeout_seconds, dont_ip_block
+- default for allow_scrape_if_max_seconds raised from 3600 to 7200
+- default for max_subscriptions raised from 32 to 128
+- timeouts no longer affect ban seconds
+- Internal: switched to pocket for the backend storage
+- creates lmdb subdirectory if missing
+- several bugfixes: filter parsing, empty tags, event ordering, chorus_compress was fixed
+
 ### Version 1.3.0 (2024-04-10, 7883d754)
 
 - `chorus_moderate` tool to approve events or pubkeys
diff --git a/docs/DEPLOYING.md b/docs/DEPLOYING.md
index a3a7a30..713f1c3 100644
--- a/docs/DEPLOYING.md
+++ b/docs/DEPLOYING.md
@@ -43,6 +43,7 @@ sudo chown $(id -u) /opt/chorus/src
 cd /opt/chorus/src
 git clone https://github.com/mikedilger/chorus
 cd chorus
+git checkout latest
 ```
 
 Check if you have `rustc` and `cargo` installed. If so, you can skip this part.
@@ -174,6 +175,7 @@ sudo journalctl -f -u chorus.service
 ```
 
 ## Updating
+
 ````bash
 cd /opt/chorus/src/chorus
 git pull