diff --git a/CHANGELOG.txt b/CHANGELOG.txt
index 6578e911..2458d618 100644
--- a/CHANGELOG.txt
+++ b/CHANGELOG.txt
@@ -1,4 +1,11 @@
 2026-03-05
+fix: use service hostname instead of localhost for PostgreSQL in CI
+  - Remove port mapping (5432:5432) to avoid port conflicts on self-hosted runners
+  - Use 'postgres' hostname instead of 'localhost' for database connection
+  - Service containers in Forgejo Actions are accessible via their service name
+  - Fixes "port is already allocated" error when runner has existing PostgreSQL
+Files: .forgejo/workflows/build.yaml
+
 perf: optimize CI caching for faster builds
   - Split deps and _build into separate caches for better granularity and hit rates
   - Add Elixir/OTP version to cache keys for version-specific builds