diff --git a/CHANGELOG.md b/CHANGELOG.md
index 6c58818d..efc5f533 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,19 @@
 # CHANGELOG
 
+## v0.4.17
+
+CHANGE: Replaced most in-line shell scripts in Docker Compose projects with installed scripts that are shared between the Docker and Linux service. This normalizes the operational configuration of both Docker shares and Linux service, i.e., to use the same env vars.
+
+CHANGE: documentation: Replaced Downloads page with downloads cards and Install guides offering latest release
+
+CHANGE: documentation: Add a guide for running zrok as a production service
+
+CHANGE: documentation: Organize the instance configuration section of getting started as a separate guide
+
+CHANGE: documentation: upgrade to Docusaurus v3
+
+FIX: Some Docker shares had broken env mountpoints
+
 ## v0.4.16
 
 FEATURE: Publish Linux packages for `zrok` CLI and a systemd service for running a reserved public share (`zrok-share`).