diff --git a/docs/docs/upgrading.mdx b/docs/docs/upgrading.mdx
new file mode 100644
index 0000000..a536007
--- /dev/null
+++ b/docs/docs/upgrading.mdx
@@ -0,0 +1,25 @@
+---
+id: upgrading
+title: Upgrading hyperglass
+sidebar_label: Upgrading
+keywords: [hyperglass, looking glass, upgrade, upgrading, version]
+description: How to upgrade hyperglass
+---
+
+## Upgrade Process
+
+To upgrade hyperglass, stop the currently-running service and upgrade via PyPI:
+
+```bash {2}
+sudo systemctl stop hyperglass
+sudo pip3 install -U hyperglass
+```
+
+## Check Current version
+
+To check the current version of hyperglass, run the following command:
+
+```bash {1}
+sudo hyperglass --version
+# hyperglass version: 1.0.0-beta.19
+```
diff --git a/docs/sidebars.js b/docs/sidebars.js
index 29e99bf..6a0b1c8 100755
--- a/docs/sidebars.js
+++ b/docs/sidebars.js
@@ -20,6 +20,7 @@ module.exports = {
             ],
         },
         { type: "category", label: "Linux Agent", items: ["agent/installation"] },
+        { type: "doc", id: "upgrading" },
         { type: "doc", id: "platforms" },
         { type: "doc", id: "license" },
     ],