diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..4541a7b
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,2 @@
+.bundle/
+vendor/
diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..7df92d9
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,59 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [v1.0.0](https://github.com/betadots/pdc/tree/v1.0.0) (2023-11-28)
+
+[Full Changelog](https://github.com/betadots/pdc/compare/v8.2.0...v1.0.0)
+
+**Merged pull requests:**
+
+- Update build\_container.yml and Dockerfile [\#25](https://github.com/betadots/pdc/pull/25) ([rwaffen](https://github.com/rwaffen))
+- Update voxpupuli-acceptance requirement from ~\> 2.1 to ~\> 3.0 [\#24](https://github.com/betadots/pdc/pull/24) ([dependabot[bot]](https://github.com/apps/dependabot))
+- update ci to use v2 [\#23](https://github.com/betadots/pdc/pull/23) ([rwaffen](https://github.com/rwaffen))
+- add build step to build development tag again [\#22](https://github.com/betadots/pdc/pull/22) ([rwaffen](https://github.com/rwaffen))
+- add terraform 1.6.2 [\#21](https://github.com/betadots/pdc/pull/21) ([rwaffen](https://github.com/rwaffen))
+
+## [v8.2.0](https://github.com/betadots/pdc/tree/v8.2.0) (2023-10-06)
+
+[Full Changelog](https://github.com/betadots/pdc/compare/v7.26.0...v8.2.0)
+
+**Merged pull requests:**
+
+- add if to build major versions depending on tag version name [\#19](https://github.com/betadots/pdc/pull/19) ([rwaffen](https://github.com/rwaffen))
+
+## [v7.26.0](https://github.com/betadots/pdc/tree/v7.26.0) (2023-10-06)
+
+[Full Changelog](https://github.com/betadots/pdc/compare/7.25.0-rc.1...v7.26.0)
+
+**Merged pull requests:**
+
+- Extend Dockerfile with additional labels [\#18](https://github.com/betadots/pdc/pull/18) ([bastelfreak](https://github.com/bastelfreak))
+- purge unneeded files in Dockerfile [\#17](https://github.com/betadots/pdc/pull/17) ([bastelfreak](https://github.com/bastelfreak))
+- Install ca-certificates in Dockerfile [\#16](https://github.com/betadots/pdc/pull/16) ([bastelfreak](https://github.com/bastelfreak))
+- update container test build gha [\#15](https://github.com/betadots/pdc/pull/15) ([rwaffen](https://github.com/rwaffen))
+- update container build gha [\#14](https://github.com/betadots/pdc/pull/14) ([rwaffen](https://github.com/rwaffen))
+- use Jammy packages on Ubuntu 22.04, not Focal [\#13](https://github.com/betadots/pdc/pull/13) ([bastelfreak](https://github.com/bastelfreak))
+- Run CI on PRs and merged to main [\#12](https://github.com/betadots/pdc/pull/12) ([bastelfreak](https://github.com/bastelfreak))
+- Test Gem installation in CI [\#11](https://github.com/betadots/pdc/pull/11) ([bastelfreak](https://github.com/bastelfreak))
+- Add bolt to Dockerfile [\#10](https://github.com/betadots/pdc/pull/10) ([bastelfreak](https://github.com/bastelfreak))
+- Bump docker/build-push-action from 4 to 5 [\#9](https://github.com/betadots/pdc/pull/9) ([dependabot[bot]](https://github.com/apps/dependabot))
+- Bump docker/login-action from 2.1.0 to 3.0.0 [\#8](https://github.com/betadots/pdc/pull/8) ([dependabot[bot]](https://github.com/apps/dependabot))
+- Bump actions/checkout from 3 to 4 [\#7](https://github.com/betadots/pdc/pull/7) ([dependabot[bot]](https://github.com/apps/dependabot))
+- Bump ubuntu from 20.04 to 22.04 [\#6](https://github.com/betadots/pdc/pull/6) ([dependabot[bot]](https://github.com/apps/dependabot))
+- dependabot: check for github actions, docker and gems [\#5](https://github.com/betadots/pdc/pull/5) ([bastelfreak](https://github.com/bastelfreak))
+- Update ra10ke requirement from ~\> 2.0 to ~\> 3.0 [\#4](https://github.com/betadots/pdc/pull/4) ([dependabot[bot]](https://github.com/apps/dependabot))
+- Update voxpupuli-test requirement from ~\> 6.0 to ~\> 7.0 [\#3](https://github.com/betadots/pdc/pull/3) ([dependabot[bot]](https://github.com/apps/dependabot))
+- Update r10k requirement from ~\> 3.15 to ~\> 4.0 [\#2](https://github.com/betadots/pdc/pull/2) ([dependabot[bot]](https://github.com/apps/dependabot))
+
+## [7.25.0-rc.1](https://github.com/betadots/pdc/tree/7.25.0-rc.1) (2023-07-11)
+
+[Full Changelog](https://github.com/betadots/pdc/compare/3782c73e9407d86394a27e959cb84731290db4e3...7.25.0-rc.1)
+
+**Merged pull requests:**
+
+- Update voxpupuli-acceptance requirement from ~\> 1.2 to ~\> 2.1 [\#1](https://github.com/betadots/pdc/pull/1) ([dependabot[bot]](https://github.com/apps/dependabot))
+
+
+
+\* *This Changelog was automatically generated by [github_changelog_generator](https://github.com/github-changelog-generator/github-changelog-generator)*
diff --git a/Gemfile b/Gemfile
index ca9917b..d861874 100644
--- a/Gemfile
+++ b/Gemfile
@@ -9,3 +9,7 @@ gem 'r10k',                          '~> 4.0'
 gem 'ra10ke',                        '~> 3.0'
 gem 'voxpupuli-acceptance',          '~> 3.0'
 gem 'voxpupuli-test',                '~> 7.0'
+
+group :release do
+  gem 'github_changelog_generator', '~> 1.16.4', require: false
+end
diff --git a/RELEASE.md b/RELEASE.md
new file mode 100644
index 0000000..e2562a8
--- /dev/null
+++ b/RELEASE.md
@@ -0,0 +1,28 @@
+# How to make a release
+
+Create a Release PR.
+The release branch has to have the version in the name, because this will be used as `future_version` of the github cnahgelog generator.
+
+```
+git switch main
+git pull -r
+git switch -c release-v1.0.0
+
+bundle config set --local path vendor/bundle
+bundle config set --local with 'release'
+bundle install
+
+CHANGELOG_GITHUB_TOKEN="token_MC_tokenface" bundle exec rake changelog
+
+git commit -am 'Release v1.0.0'
+git push origin release-v1.0.0
+```
+
+After the merge do:
+
+```
+git switch main
+git pull -r
+git tag v1.0.0
+git push --tags
+```
diff --git a/Rakefile b/Rakefile
new file mode 100644
index 0000000..5ebce46
--- /dev/null
+++ b/Rakefile
@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+begin
+  require 'rubygems'
+  require 'github_changelog_generator/task'
+rescue LoadError
+  # github_changelog_generator isn't available, so we won't define a rake task with it
+else
+  GitHubChangelogGenerator::RakeTask.new :changelog do |config|
+    config.header = "# Changelog\n\nAll notable changes to this project will be documented in this file."
+    config.exclude_labels = %w[duplicate question invalid wontfix wont-fix skip-changelog]
+    config.user = 'betadots'
+    config.project = 'pdc'
+    # get branch name from git and strip off any prefixes (e.g. 'release-')
+    config.future_release = `git rev-parse --abbrev-ref HEAD`.strip.split('-', 2).last
+  end
+end