From e107f483a7ea14f89588d38caca7e536651fc52d Mon Sep 17 00:00:00 2001
From: Nick Chase <nchase@earthlink.net>
Date: Wed, 29 Apr 2026 11:34:16 -0400
Subject: [PATCH 1/2] Reorganize to add prerequisits to SSH Quickstart

---
 docs/quickstarts/quickstart-2-remote.md | 51 ++++++++++++++++++++++++-
 1 file changed, 50 insertions(+), 1 deletion(-)

diff --git a/docs/quickstarts/quickstart-2-remote.md b/docs/quickstarts/quickstart-2-remote.md
index 03fd859e4..09005d7f4 100644
--- a/docs/quickstarts/quickstart-2-remote.md
+++ b/docs/quickstarts/quickstart-2-remote.md
@@ -15,7 +15,56 @@ Note that if you have already done one of the other quickstarts, such as our AWS
 
 Before proceeding, make sure your management cluster meets the following requirements:
 
-1. A [default storage class](https://kubernetes.io/docs/tasks/administer-cluster/change-default-storage-class/) is configured on the management cluster to support Persistent Volumes.
+1. Increase filesystem limits by adding the following to `/etc/sysctl.conf`:
+
+    ```bash
+    fs.inotify.max_user_instances=8192
+    fs.inotify.max_user_watches=524288
+    ```
+
+    Then set `systemd` limits:
+
+    ```bash
+    sudo tee -a /etc/systemd/system.conf <<EOF
+    DefaultLimitNOFILE=1048576
+    EOF
+
+    sudo tee -a /etc/systemd/user.conf <<EOF
+    DefaultLimitNOFILE=1048576
+    EOF
+    ```
+
+    Next set the OS limits:
+
+    ```bash
+    sudo tee -a /etc/security/limits.conf <<EOF
+    * soft nofile 1048576
+    * hard nofile 1048576
+    EOF
+    ```
+
+    Finally, apply and reboot:
+
+    ```bash
+    sudo systemctl daemon-reexec
+    sudo systemctl daemon-reload
+    sudo reboot
+    ```
+
+1. A [default storage class](https://kubernetes.io/docs/tasks/administer-cluster/change-default-storage-class/) is configured on the management cluster to support Persistent Volumes.  For example:
+
+    ```bash
+    helm repo add openebs https://openebs.github.io/openebs
+    helm repo update
+
+    helm install openebs openebs/openebs \
+      --namespace openebs \
+      --create-namespace
+
+    kubectl patch storageclass openebs-hostpath \
+      -p '{"metadata": {"annotations":{"storageclass.kubernetes.io/is-default-class":"true"}}}'  
+    ```
+
 2. If the API server will be exposed as a `LoadBalancer`, ensure the appropriate cloud provider is installed on the management cluster.
 
 ## Create a Secret object containing the private SSH key to access remote machines

From 6a3e97a595f20a277fe1aacc37b957b0ac43ee21 Mon Sep 17 00:00:00 2001
From: Nick Chase <nchase@earthlink.net>
Date: Thu, 30 Apr 2026 21:14:51 -0400
Subject: [PATCH 2/2] Add workaround to remote quickstart

---
 docs/quickstarts/quickstart-2-remote.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/quickstarts/quickstart-2-remote.md b/docs/quickstarts/quickstart-2-remote.md
index 09005d7f4..904362dc1 100644
--- a/docs/quickstarts/quickstart-2-remote.md
+++ b/docs/quickstarts/quickstart-2-remote.md
@@ -65,6 +65,8 @@ Before proceeding, make sure your management cluster meets the following require
       -p '{"metadata": {"annotations":{"storageclass.kubernetes.io/is-default-class":"true"}}}'  
     ```
 
+1. Make sure the key you will use to log in as root exists on the child machines.
+
 2. If the API server will be exposed as a `LoadBalancer`, ensure the appropriate cloud provider is installed on the management cluster.
 
 ## Create a Secret object containing the private SSH key to access remote machines