diff --git a/src/pages/docs/charts/appwrite.mdx b/src/pages/docs/charts/appwrite.mdx
index e2e55cd..2f94958 100644
--- a/src/pages/docs/charts/appwrite.mdx
+++ b/src/pages/docs/charts/appwrite.mdx
@@ -22,7 +22,7 @@ multi-workload chart (~20 Kubernetes Deployments) with bundled MariaDB and Redis
 
 ## Key Features
 
-- **Full Appwrite stack** — API, Console v7.5.7, Realtime WebSocket, 12 workers, schedulers, maintenance
+- **Full Appwrite stack** — API, Console v8.7.5, Realtime WebSocket, 12 workers, schedulers, maintenance
 - **~20 Kubernetes workloads** — each component runs independently and scales separately
 - **MariaDB + Redis** — bundled subcharts or external connections
 - **Shared PVCs** — uploads, cache, certificates, functions, builds, and sites shared across pods
@@ -234,6 +234,15 @@ ingress:
 
 </DocsTabs>
 
+## Upgrade Notes
+
+<Callout type="warning" title="Appwrite 1.9.5 requires database migrations">
+  Appwrite 1.9.5 requires the upstream migration step even when upgrading from Appwrite 1.9.0. After `helm
+  upgrade`, run the Appwrite migrate command against an Appwrite API pod before returning production traffic to the
+  release, for example `kubectl exec deploy/<release>-appwrite-api -- appwrite migrate` adjusted to your release name
+  and namespace.
+</Callout>
+
 ## Configuration Reference
 
 ### Core
@@ -249,9 +258,9 @@ ingress:
 | Parameter                  | Type   | Default                       | Description            |
 | -------------------------- | ------ | ----------------------------- | ---------------------- |
 | `image.repository`         | string | `docker.io/appwrite/appwrite` | Appwrite server image. |
-| `image.tag`                | string | `"1.8.1"`                     | Appwrite image tag.    |
+| `image.tag`                | string | `"1.9.5"`                     | Appwrite image tag.    |
 | `console.image.repository` | string | `docker.io/appwrite/console`  | Console image.         |
-| `console.image.tag`        | string | `"7.5.7"`                     | Console image tag.     |
+| `console.image.tag`        | string | `"8.7.5"`                     | Console image tag.     |
 
 ### Appwrite Configuration