diff --git a/docusaurus.config.js b/docusaurus.config.js
index 5b9e6fbf..60bda603 100644
--- a/docusaurus.config.js
+++ b/docusaurus.config.js
@@ -31,7 +31,7 @@ module.exports = {
       id: 'start',
       content:
           '<div class="header-item">⭐️ If you like KubeVela, give it a star on <a target="_blank" rel="noopener noreferrer" href="https://github.com/kubevela/kubevela">GitHub</a>!⭐️</div>' +
-          '<div class="header-item"><span>KubeVela v1.8.0 is now available.(2023-04-20)</span> <a target="_blank" style="color: var(--ifm-color-primary)" rel="noopener noreferrer" href="https://github.com/kubevela/kubevela/releases/tag/v1.8.0">Read Release Note</a></div>',
+          '<div class="header-item"><span>KubeVela v1.9.0 is now available.(2023-06-15)</span> <a target="_blank" style="color: var(--ifm-color-primary)" rel="noopener noreferrer" href="https://github.com/kubevela/kubevela/releases/tag/v1.9.0">Read Release Note</a></div>',
     },
     algolia: {
       appId: 'PXMFHFWUGZ',
diff --git a/versioned_docs/version-v1.9/contributor/code-contribute.md b/versioned_docs/version-v1.9/contributor/code-contribute.md
index 33098060..de3bf2c2 100644
--- a/versioned_docs/version-v1.9/contributor/code-contribute.md
+++ b/versioned_docs/version-v1.9/contributor/code-contribute.md
@@ -264,7 +264,7 @@ Before start, please make sure you have already started the vela controller envi
 make run-apiserver
 ```
 
-By default, the apiserver will serving at "0.0.0.0:8000".
+By default, the apiserver will be serving at "0.0.0.0:8000".
 
 Get the VelaUX code by:
 
diff --git a/versioned_docs/version-v1.9/platform-engineers/system-operation/migration-from-old-version.md b/versioned_docs/version-v1.9/platform-engineers/system-operation/migration-from-old-version.md
index 2b559e25..5f87bb35 100644
--- a/versioned_docs/version-v1.9/platform-engineers/system-operation/migration-from-old-version.md
+++ b/versioned_docs/version-v1.9/platform-engineers/system-operation/migration-from-old-version.md
@@ -6,6 +6,32 @@ This doc aims to provide a migration guide from old versions to the new ones wit
 
 KubeVela has [release cadence](../../contributor/release-process.md) for every 2-3 months, we'll only maintain for the last 2 releases. As a result, you're highly recommended to upgrade along with the community. We'll strictly align with the [semver version rule](https://semver.org/) for compatibility.
 
+## From v1.8.x to v1.9.x
+
+:::caution
+1. Legacy code removal. Basically you will not be able to use EnvBinding, HealthScope, ScopeDefinition and other objects in old KubeVela (<1.0), like ApplicationConfiguration.
+2. Registry migrated from kubevela.net OSS storage to GitHub pages.
+> Notice: the "hub.kubevela.net", "charts.kubevela.net" and "addons.kubevela.net" will not be served in the future.
+> 1. For docker images in "hub.kubevela.net", replace it with "docker.io" or "ghcr.io/kubevela".
+> 2. For helm charts in "charts.kubevela.net", replace it with "kubevela.github.io/charts".
+> 3. For addons in "addons.kubevela.net", replace it with "kubevela.github.io/catalog/official".
+> 
+> You can run the following command to update your addon registry.
+> ```shell
+> vela addon registry delete KubeVela
+> vela addon registry add KubeVela --type helm --endpoint=https://kubevela.github.io/catalog/official
+> vela addon registry add experimental --type helm --endpoint=https://kubevela.github.io/catalog/experimental
+> ```
+:::
+
+1. Upgrade your kubevela chart
+
+```
+helm repo add kubevela https://kubevela.github.io/charts
+helm repo update
+helm upgrade -n vela-system --install kubevela kubevela/vela-core --version 1.9.5 --wait
+```
+
 ## From v1.7.x to v1.8.x
 
 These isn't too much work to be done for upgrading from v1.7.x to v1.8.x for usage.