From 7373c885b219f644c0455a3768fe4ad3ad867cf4 Mon Sep 17 00:00:00 2001
From: Mike Guthrie <mike.guthrie@netfoundry.io>
Date: Fri, 11 Apr 2025 11:13:00 -0400
Subject: [PATCH] commit before updating from main

---
 docs/myzrok/upgrading.md | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)
 create mode 100644 docs/myzrok/upgrading.md

diff --git a/docs/myzrok/upgrading.md b/docs/myzrok/upgrading.md
new file mode 100644
index 00000000..d69d64d4
--- /dev/null
+++ b/docs/myzrok/upgrading.md
@@ -0,0 +1,25 @@
+---
+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.
+
+Run the following to rebase your environment to use the new versioned API:
+```
+  zrok rebase apiEndpoint https://api-v1.zrok.io
+```
+
+Resume zrok API interactions as normal!
+
+
+## Trouble after upgrade?
+
+If you run into any issues after upgrading your environment, try running the following:
+
+```
+zrok disable
+zrok config set apiEndpoint https://api-v1.zrok.io
+zrok enable <your account token>
+
+```