diff --git a/CHANGELOG.md b/CHANGELOG.md
index 37dbb713..653e4305 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,7 +1,33 @@
 
+<a name="v3.1.0"></a>
+## [v3.1.0](https://github.com/kreuzwerker/terraform-provider-docker/compare/v3.0.2...v3.1.0) (2025-04-13)
+
+### Chore
+
+* update Go version to 1.22 for consistency across workflows, jo… ([#613](https://github.com/kreuzwerker/terraform-provider-docker/issues/613))
+
+### Feat
+
+* support setting cpu shares ([#575](https://github.com/kreuzwerker/terraform-provider-docker/issues/575))
+
+### Fix
+
+* Use build_args everywhere and update documentation ([#681](https://github.com/kreuzwerker/terraform-provider-docker/issues/681))
+* Compress build context before sending it to Docker ([#461](https://github.com/kreuzwerker/terraform-provider-docker/issues/461))
+* Set correct default network driver and fix a test ([#677](https://github.com/kreuzwerker/terraform-provider-docker/issues/677))
+
+### Typo
+
+* s/presend/present/ ([#606](https://github.com/kreuzwerker/terraform-provider-docker/issues/606))
+
+
 <a name="v3.0.2"></a>
 ## [v3.0.2](https://github.com/kreuzwerker/terraform-provider-docker/compare/v3.0.1...v3.0.2) (2023-03-17)
 
+### Chore
+
+* Prepare release v3.0.2
+
 ### Docs
 
 * correct spelling of "networks_advanced" ([#517](https://github.com/kreuzwerker/terraform-provider-docker/issues/517))
diff --git a/README.md b/README.md
index 1f21b515..f0aad9b4 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/3.0.2/docs) of the registry
+Take a look at the examples in the [documentation](https://registry.terraform.io/providers/kreuzwerker/docker/3.1.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 = "3.0.2"
+      version = "3.1.0"
     }
   }
 }
diff --git a/docs/index.md b/docs/index.md
index bef2113a..67098308 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -25,7 +25,7 @@ terraform {
   required_providers {
     docker = {
       source  = "kreuzwerker/docker"
-      version = "3.0.2"
+      version = "3.1.0"
     }
   }
 }
@@ -50,7 +50,7 @@ Terraform 0.12 and earlier:
 
 ```terraform
 provider "docker" {
-  version = "~> 3.0.2"
+  version = "~> 3.1.0"
   host    = "unix:///var/run/docker.sock"
 }
 
diff --git a/examples/provider/provider-tf12.tf b/examples/provider/provider-tf12.tf
index bba08918..89c828a7 100644
--- a/examples/provider/provider-tf12.tf
+++ b/examples/provider/provider-tf12.tf
@@ -1,5 +1,5 @@
 provider "docker" {
-  version = "~> 3.0.2"
+  version = "~> 3.1.0"
   host    = "unix:///var/run/docker.sock"
 }
 
diff --git a/examples/provider/provider-tf13.tf b/examples/provider/provider-tf13.tf
index fc79b915..08c6f1ff 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 = "3.0.2"
+      version = "3.1.0"
     }
   }
 }