From b405bf54bfae91b7fc78ddbcd691ec62a12c13cd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=F0=9F=8F=94=EF=B8=8F=20Peak?=
 <122374094+peaklabs-dev@users.noreply.github.com>
Date: Tue, 9 Dec 2025 17:46:53 +0100
Subject: [PATCH] docs: update changelog (#7548)

---
 CHANGELOG.md | 81 ++++++++++++++++++++++++++++++++++++++++++++++++----
 1 file changed, 76 insertions(+), 5 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 680444d4f..084bee846 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,21 +2,92 @@
 
 All notable changes to this project will be documented in this file.
 
-## [5.0.0-alpha.1] - XX-XX-2025
+## [5.0.0-alpha.1] – 2026-XX-XX
 
 ### Release Highlights
 
 -
 
-### New Features
+### Added
+
+- **v4 to v5 upgrade migration**
+  - Added Coolify v4 database as `old_pgsql` connection
+  -
+
+### Changed
+
+- Upgraded all Composer and Node dependencies, most notably: PHP to 8.5 (from 8.4), TailwindCSS to v4.0 (from v3) and Laravel to v12 (from v10)
+- **Docker:**
+  - Upgraded all Docker dependencies, most notably: Postgres to v18 (from v15) and Redis to v8 (from v7)
+  -
+- **Laravel Configurations:**
+  - Changed hashing algorithm from `bcrypt` to `argon2id` for enhanced security
+  - Encrypt user sessions and expire inactive sessions after 24h
+  - Redirect Laravel logs to `stderr` so they can be viewed in docker logs
+  - Configured production logging to rotate automatically and keep only the last 10 days of logs to reduce disk usage
+  - Changed production log level from `debug` to `warning` to reduce disk usage and avoid logging sensitive information
+  - Updated all Laravel config files to the latest version and removed all unused config options
+- Changed license from `Apache-2.0` to `AGPL-3.0`
+
+### Deprecated
 
 -
 
-### Bug Fixes
+### Removed
 
 -
 
-### Refactor
+### Fixed
 
-- All GitHub Action workflows have been refactored with better structure, naming, caching and more.
+- `laravel.log` file growing indefinitely and consuming excessive disk space
 -
+
+### Security
+
+-
+
+### Performance
+
+-
+
+### Maintenance
+
+- **Testing:**
+  - Added custom Architecture test that enforces Laravel & PHP best practices to ensure security and consistency across the codebase
+- **Tooling:**
+  - Added Rector & Rector Laravel with a strict configuration for automatic refactoring of the codebase
+  - Added a strict custom Laravel Pint preset for consistent PHP formatting across the codebase
+  - Added Larastan (PHPStan) Level `max` for code analysis and type checking
+  - Added custom composer scripts to run refactors, formatting, linting, tests and type-coverage
+  - Added strict `AppServiceProvider.php`:
+    - Optionally enforce HTTPS for the Coolify dashboard
+    - Enforce strong password validation rules in production
+    - Disable destructive artisan commands in production
+    - Automatically eager load all relationships to prevent N+1 queries
+    - Configure models and enforce morph map for polymorphic relationships
+    - Enforce immutable dates globally
+    - Fake sleeps and prevent stray HTTP requests in testing
+    - Prevent exception truncation in development
+    - Use aggressive Vite prefetching for better performance
+  - Only install Ray in development and remove all `ray()` calls from production code via Rector
+  - Switched Node package manager from `NPM` to `Bun` for improved security and performance
+  - Added `$schema` to `composer.json` and `package.json`
+- **Coolify GitHub Repository:**
+  - Pinned all GitHub actions to full length git SHAs to minimize the risk of supply chain attacks
+  - Set permissions explicitly on each GitHub workflow to only give the minimum required permissions
+  - Renamed all GitHub action workflows for improved clarity
+  - Cancel in-progress action runs when a new run is triggered
+  - Improved `SECURITY.md` formatting and wording and added the support policy for `v5.x`
+  - Refactored the GitHub issue templates to use issue types and improved formatting and wording
+  - Moved `README.md` assets into `.github/assets/` to easier exclude them from the core repository code
+  - Removed the `chore-remove-labels-and-assignees-on-close.yml` workflow as labels and assignees are now kept when closing Issues and PRs
+
+### Refactored
+
+- Completely refactored all database migrations for a cleaner, more consistent and optimized schema
+
+## Issues
+
+- fixed: <https://github.com/coollabsio/coolify/issues/6407>
+- fixed: <https://github.com/coollabsio/coolify/issues/3578>
+- fixed: