diff --git a/CHANGELOG.txt b/CHANGELOG.txt
index d580b999..b5273241 100644
--- a/CHANGELOG.txt
+++ b/CHANGELOG.txt
@@ -1,4 +1,11 @@
 2026-03-05
+ci: add explicit wait for PostgreSQL and database creation step
+  - Add pg_isready wait loop to ensure PostgreSQL service is fully ready before running tests
+  - Run mix ecto.create explicitly to create database before test suite runs
+  - Fixes "connection refused" errors when PostgreSQL service is still starting up
+  - Prevents "database couldn't be created: killed" errors in CI pipeline
+Files: .forgejo/workflows/build.yaml
+
 fix: update alert_type atom comparisons to strings in AlertLive
   - Changed all alert_type == :device_down to strings in AlertLive.Index
   - Fixes alert filtering and counting after schema migration