diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..6f71030
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,18 @@
+# Changelog
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [unreleased](https://git.d3data.de/D3Public/OXID-Deployer/compare/1.0.0.0...rel_1.x)
+
+## [1.0.0.0](https://git.d3data.de/D3Public/OXID-Deployer/releases/tag/1.0.0.0) - 2024-11-03
+### Added
+- initial implementation
+  - OXID base recipe
+    - additional shop depend deployment tasks
+  - additional task
+    - show OXID version
+    - create backup
+    - clone database
+    - run migrations