diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..022c0cf
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,110 @@
+# 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).
+
+## v0.4.0 (2023-04-27)
+
+### Chore
+
+ - <csr-id-0e2536ffb35123af9be264027f21b430f68ccc9d/> exclude non essential files from release
+ - <csr-id-2894e5810681167b9a5975fde6a0d9f8647b0fa7/> updated port for the tests
+
+### New Features
+
+ - <csr-id-60752cb400dda3dbb0b4fcd770f1f2328f5f097f/> Dockerfile to run the server
+
+### Commit Statistics
+
+<csr-read-only-do-not-edit/>
+
+ - 4 commits contributed to the release over the course of 23 calendar days.
+ - 23 days passed between releases.
+ - 3 commits were understood as [conventional](https://www.conventionalcommits.org).
+ - 0 issues like '(#ID)' were seen in commit messages
+
+### Commit Details
+
+<csr-read-only-do-not-edit/>
+
+<details><summary>view details</summary>
+
+ * **Uncategorized**
+    - Exclude non essential files from release ([`0e2536f`](https://github.com/ssoudan/oss-vizier/commit/0e2536ffb35123af9be264027f21b430f68ccc9d))
+    - Updated port for the tests ([`2894e58`](https://github.com/ssoudan/oss-vizier/commit/2894e5810681167b9a5975fde6a0d9f8647b0fa7))
+    - Dockerfile to run the server ([`60752cb`](https://github.com/ssoudan/oss-vizier/commit/60752cb400dda3dbb0b4fcd770f1f2328f5f097f))
+    - [version] -> 0.4.0 ([`5f6cf61`](https://github.com/ssoudan/oss-vizier/commit/5f6cf6123aa699ae1bbf73691f25dd91f26b854a))
+</details>
+
+## v0.3.0 (2023-04-03)
+
+### Commit Statistics
+
+<csr-read-only-do-not-edit/>
+
+ - 6 commits contributed to the release over the course of 119 calendar days.
+ - 119 days passed between releases.
+ - 0 commits were understood as [conventional](https://www.conventionalcommits.org).
+ - 0 issues like '(#ID)' were seen in commit messages
+
+### Commit Details
+
+<csr-read-only-do-not-edit/>
+
+<details><summary>view details</summary>
+
+ * **Uncategorized**
+    - [fmt] ([`6d38c9f`](https://github.com/ssoudan/oss-vizier/commit/6d38c9f7be4523f8c6d02e970b63ddce9209cece))
+    - [deps] updated ([`0d64f80`](https://github.com/ssoudan/oss-vizier/commit/0d64f80bf2dec47e055fabbb055703bab461f1bf))
+    - [fix] docrs ([`6ab4b65`](https://github.com/ssoudan/oss-vizier/commit/6ab4b65d9a95a3236f3953866cf56f28875e767f))
+    - [fix] tests ([`4de5613`](https://github.com/ssoudan/oss-vizier/commit/4de561382d609d78a51a9409aa15fd7eb61b84a3))
+    - [fix] run_server ([`8efb306`](https://github.com/ssoudan/oss-vizier/commit/8efb306799e5002dfaab1a60fad8b9ee900dc885))
+    - [version] -> 0.3.0 ([`743b61d`](https://github.com/ssoudan/oss-vizier/commit/743b61d5c9271df3c6a42f5220d98ef2a141abb0))
+</details>
+
+## v0.2.0 (2022-12-04)
+
+### Commit Statistics
+
+<csr-read-only-do-not-edit/>
+
+ - 3 commits contributed to the release.
+ - 0 commits were understood as [conventional](https://www.conventionalcommits.org).
+ - 0 issues like '(#ID)' were seen in commit messages
+
+### Commit Details
+
+<csr-read-only-do-not-edit/>
+
+<details><summary>view details</summary>
+
+ * **Uncategorized**
+    - [+] More generic constructor ([`c55c3f1`](https://github.com/ssoudan/oss-vizier/commit/c55c3f19d9560beb2b2a219b7d0c8c19bc28123a))
+    - [+] removed unused option ([`8ca7a88`](https://github.com/ssoudan/oss-vizier/commit/8ca7a887c2186c6b63babb5eacd8f1401d994cc2))
+    - [version] -> 0.2.0 ([`695a14c`](https://github.com/ssoudan/oss-vizier/commit/695a14c5a3fb45c36066056c3cbe7105dfdb503d))
+</details>
+
+## v0.1.0 (2022-12-04)
+
+### Commit Statistics
+
+<csr-read-only-do-not-edit/>
+
+ - 3 commits contributed to the release.
+ - 0 commits were understood as [conventional](https://www.conventionalcommits.org).
+ - 0 issues like '(#ID)' were seen in commit messages
+
+### Commit Details
+
+<csr-read-only-do-not-edit/>
+
+<details><summary>view details</summary>
+
+ * **Uncategorized**
+    - [deps] updated ([`5002c12`](https://github.com/ssoudan/oss-vizier/commit/5002c124123749791d1a1d692f135cd0fa3ba22d))
+    - [fix] build ([`3f10a7a`](https://github.com/ssoudan/oss-vizier/commit/3f10a7a0a4ef95df5adca4fbdcda2328efc7fca5))
+    - [init] ([`f4b111b`](https://github.com/ssoudan/oss-vizier/commit/f4b111b1cf0d020fa3448bc63afd1cda65aba8f7))
+</details>
+