diff --git a/CHANGELOG.md b/CHANGELOG.md
index 59666a16c..8e1d3ee77 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,7 +1,24 @@
 
+<a name="v3.0.0"></a>
+## [v3.0.0](https://github.com/kreuzwerker/terraform-provider-docker/compare/v2.25.0...v3.0.0) (2023-01-13)
+
+### Docs
+
+* Update documentation.
+* Add migration guide and update README ([#502](https://github.com/kreuzwerker/terraform-provider-docker/issues/502))
+
+### Feat
+
+* Prepare v3 release ([#503](https://github.com/kreuzwerker/terraform-provider-docker/issues/503))
+
+
 <a name="v2.25.0"></a>
 ## [v2.25.0](https://github.com/kreuzwerker/terraform-provider-docker/compare/v2.24.0...v2.25.0) (2023-01-05)
 
+### Chore
+
+* Prepare release v2.25.0
+
 ### Docs
 
 * Add documentation of remote hosts. ([#498](https://github.com/kreuzwerker/terraform-provider-docker/issues/498))
diff --git a/README.md b/README.md
index d2542bd42..aa1593067 100644
--- a/README.md
+++ b/README.md
@@ -26,7 +26,7 @@ Do you want to migrate from `v2.x` to `v3.x`? Please read the [migration guide](
 
 ## Example usage
 
-Take a look at the examples in the [documentation](https://registry.terraform.io/providers/kreuzwerker/docker/2.25.0/docs) of the registry
+Take a look at the examples in the [documentation](https://registry.terraform.io/providers/kreuzwerker/docker/3.0.0/docs) of the registry
 or use the following example:
 
 
@@ -38,7 +38,7 @@ terraform {
     # since new versions are released frequently
     docker = {
       source  = "kreuzwerker/docker"
-      version = "2.25.0"
+      version = "3.0.0"
     }
   }
 }
diff --git a/docs/index.md b/docs/index.md
index c1987f3c1..ba6a0330f 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -25,7 +25,7 @@ terraform {
   required_providers {
     docker = {
       source  = "kreuzwerker/docker"
-      version = "2.25.0"
+      version = "3.0.0"
     }
   }
 }
@@ -50,7 +50,7 @@ Terraform 0.12 and earlier:
 
 ```terraform
 provider "docker" {
-  version = "~> 2.25.0"
+  version = "~> 3.0.0"
   host    = "unix:///var/run/docker.sock"
 }
 
diff --git a/examples/provider/provider-tf12.tf b/examples/provider/provider-tf12.tf
index 91a439985..edf6789b6 100644
--- a/examples/provider/provider-tf12.tf
+++ b/examples/provider/provider-tf12.tf
@@ -1,5 +1,5 @@
 provider "docker" {
-  version = "~> 2.25.0"
+  version = "~> 3.0.0"
   host    = "unix:///var/run/docker.sock"
 }
 
diff --git a/examples/provider/provider-tf13.tf b/examples/provider/provider-tf13.tf
index da913a6cd..ee32f70ba 100644
--- a/examples/provider/provider-tf13.tf
+++ b/examples/provider/provider-tf13.tf
@@ -2,7 +2,7 @@ terraform {
   required_providers {
     docker = {
       source  = "kreuzwerker/docker"
-      version = "2.25.0"
+      version = "3.0.0"
     }
   }
 }