From b835bcff58398bddecf86efdd3a5496a6bde7fa1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pawe=C5=82=20Bojanowski?= <pawel.bojanowski@loft.sh>
Date: Tue, 30 Sep 2025 13:24:16 +0200
Subject: [PATCH] add section about upgrading vCluster Standalone
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: Paweł Bojanowski <pawel.bojanowski@loft.sh>
---
 .../deploy/control-plane/binary/manage.mdx    | 33 ++++++++++++++++++-
 1 file changed, 32 insertions(+), 1 deletion(-)

diff --git a/vcluster/deploy/control-plane/binary/manage.mdx b/vcluster/deploy/control-plane/binary/manage.mdx
index 12b606241..737373a31 100644
--- a/vcluster/deploy/control-plane/binary/manage.mdx
+++ b/vcluster/deploy/control-plane/binary/manage.mdx
@@ -19,6 +19,37 @@ import TenancySupport from '../../../_fragments/tenancy-support.mdx';
 
 <DeployChangesStandalone />
 
+## Upgrading vCluster Standalone version
+
+To upgrade a vCluster Standalone to the new version, download the binary from the releases page, and then restart the vCluster systemD service.
+
+<Flow>
+  <Step>
+    On the control-plane node, download the binary for the target version:
+    ```shell title="Download vCluster standalone binary"
+    export VCLUSTER_VERSION="vX.Y.Z" # modify to the target version
+    export TARGETARCH="amd64" # amd64 / arm64
+    curl -fsSLk -o /tmp/vcluster-new "https://github.com/loft-sh/vcluster/releases/download/${VCLUSTER_VERSION}/vcluster-linux-${TARGETARCH}-standalone"
+    ```
+    then, copy it to the `/var/lib/vcluster/bin/vcluster`:
+
+    ```shell title="Upgrade binary"
+    chmod +x /tmp/vcluster-new
+    # copy old version as a backup
+    cp /var/lib/vcluster/bin/vcluster /tmp/vcluster-old.bak
+    cp /tmp/vcluster-new /var/lib/vcluster/bin/vcluster
+    ```
+  </Step>
+  <Step>
+    Restart vCluster systemD service to deploy your changes.
+
+    ```bash title="Restart vCluster"
+    systemctl restart vcluster.service
+    ```
+
+  </Step>
+</Flow>
+
 ## Removing nodes
 
 If you have not enabled joining the control plane nodes as worker nodes, then removing vCluster
@@ -230,4 +261,4 @@ Run 'kubectl get nodes' on the control-plane to see this node join the cluster.
       </Step>
     </Flow>
   </TabItem>
-</Tabs>
\ No newline at end of file
+</Tabs>