diff --git a/CHANGELOG.md b/CHANGELOG.md
index cf54dbd..04f94e1 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,6 +3,12 @@
 All notable changes to this project will be documented in this file. This project adheres to [Semantic Versioning](http://semver.org/).
 In order to read more about upgrading and BC breaks have a look at the [UPGRADE Document](UPGRADE.md).
 
+## 3.0.0 (3. May 2023)
+
+> This release breaks the old API! Check the [UPGRADE document](UPGRADE.md) to read more about.
+
++ Version 7.0 of [deployphp/deployer](https://github.com/deployphp/deployer), see [migrate 6.x to 7.0 Guide](https://deployer.org/docs/7.x/UPGRADE#upgrade-from-6x-to-7x)
+
 ## 2.2.1 (11. January 2023)
 
 + Added `--silent=0` to unglue command to ensure CI/CD fails if an error occurs.
diff --git a/UPGRADE.md b/UPGRADE.md
index 973180f..6b2d78f 100644
--- a/UPGRADE.md
+++ b/UPGRADE.md
@@ -2,6 +2,15 @@
 
 This document will help you upgrading from a LUYA Deployer version into another. For more detailed informations about the breaking changes **click the issue detail link**, there you can examples of how to change your code.
 
+## from 2.x to 3.0
+
+https://github.com/luyadev/luya-deployer/compare/2.2.1...3.0.0
+
++ Version 7.0 of [deployphp/deployer](https://github.com/deployphp/deployer), see [migrate 6.x to 7.0 Guide](https://deployer.org/docs/7.x/UPGRADE#upgrade-from-6x-to-7x)
++ Removed FPX Support (task `luya:composerglobal` deleted)
++ Config env is now evaluated by `get('labels')['stage']` instead of `get('stage')`.
++ Removed option to ignore composer platform 
+
 ## from 2.x to 2.2
 
 + [#23](https://github.com/luyadev/luya-deployer/pull/23) FXP installation is now by default **off** instead of **on**. This is a small BC break. In order to restore original behavior use `->set('installFxpPlugin', true)`.