diff --git a/docs/myzrok/upgrading.md b/docs/myzrok/upgrading.md
index d69d64d4..e0994979 100644
--- a/docs/myzrok/upgrading.md
+++ b/docs/myzrok/upgrading.md
@@ -3,13 +3,18 @@ title: Upgrading From 0.4 to 1.0
 ---
 
 ## Upgrading an existing 0.4 environment
-If you have not already, [install the latest 1.x zrok binary](getting-started.mdx#installing-the-zrok-command) into your environment.
+If you have not already, [install the latest 1.x zrok binary](/docs/guides/install) into your environment.
 
 Run the following to rebase your environment to use the new versioned API:
 ```
   zrok rebase apiEndpoint https://api-v1.zrok.io
 ```
 
+:::note
+As of zrok `1.0.2`, the zrok rebase is automatic and the configuration will automatically be updated to the v1 API.
+:::
+
+
 Resume zrok API interactions as normal!
 
 
@@ -17,9 +22,19 @@ Resume zrok API interactions as normal!
 
 If you run into any issues after upgrading your environment, try running the following:
 
+:::warning
+Running `zrok disable` will delete any running environments or shares, and will release any reserved shares
+
+:::
 ```
 zrok disable
-zrok config set apiEndpoint https://api-v1.zrok.io
-zrok enable <your account token>
-
+```
+
+Reset the config back to the default API endpoint for the binary version
+```
+zrok config unset apiEndpoint
+```
+Create a fresh environment
+```
+zrok enable <your account token>
 ```