From a00ab73afa8abc1494216e40bbb438bf85bbbb06 Mon Sep 17 00:00:00 2001
From: Matt Leary <33221468+mleary@users.noreply.github.com>
Date: Fri, 20 Mar 2026 12:41:52 -0700
Subject: [PATCH 1/2] update helm chart overview

---
 index.qmd | 98 ++++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 97 insertions(+), 1 deletion(-)

diff --git a/index.qmd b/index.qmd
index bc20cc3b2..7adaed6fe 100644
--- a/index.qmd
+++ b/index.qmd
@@ -19,4 +19,100 @@ title: Posit Helm Charts
 
    ```{.bash}
    helm search repo rstudio
-   ```
\ No newline at end of file
+   ```
+
+## Installing Charts
+
+Example instructions to install a chart for each product are below. For full installation details, see the overview page for each product.
+
+::: {.panel-tabset}
+
+### Posit Workbench
+
+```{.bash}
+kubectl create secret generic rstudio-workbench-license \
+  --from-file=licenses/rstudio-workbench.lic
+helm install workbench rstudio/rstudio-workbench \
+  --set license.file.secret=rstudio-workbench-license \
+  --set license.file.secretKey=rstudio-workbench.lic \
+  --values workbench-values.yaml
+```
+
+### Posit Connect
+
+```{.bash}
+kubectl create secret generic rstudio-connect-license \
+  --from-file=licenses/rstudio-connect.lic
+helm install connect rstudio/rstudio-connect \
+  --set license.file.secret=rstudio-connect-license \
+  --set license.file.secretKey=rstudio-connect.lic \
+  --values connect-values.yaml
+```
+
+### Posit Package Manager
+
+```{.bash}
+kubectl create secret generic rstudio-pm-license \
+  --from-file=licenses/rstudio-pm.lic
+helm install packagemanager rstudio/rstudio-pm \
+  --set license.file.secret=rstudio-pm-license \
+  --set license.file.secretKey=rstudio-pm.lic \
+  --values pm-values.yaml
+```
+
+### Posit Chronicle
+
+```{.bash}
+helm install chronicle rstudio/posit-chronicle \
+  --values chronicle-values.yaml
+```
+
+:::
+
+You can also provide a license via `license.server` (for a license server). See each chart's values reference for details.
+
+## Upgrading a Release
+
+```{.bash}
+helm upgrade <release-name> rstudio/<chart-name> \
+  --values <values-file>.yaml
+```
+
+## Uninstalling a Release
+
+```{.bash}
+helm uninstall <release-name> --namespace posit
+```
+
+## Troubleshooting
+
+List running pods:
+
+```{.bash}
+kubectl get pods 
+```
+
+View application logs:
+
+```{.bash}
+kubectl logs <pod-name> 
+```
+
+View pod events and status:
+
+```{.bash}
+kubectl describe pod <pod-name> 
+```
+
+For troubleshooting pods themselves, and testing the installation of new packages/services, 
+open a shell in a pod:
+
+```{.bash}
+kubectl exec -it <pod-name> -- /bin/bash
+```
+
+Restart a deployment:
+
+```{.bash}
+kubectl rollout restart deployment/<deployment-name>
+```
\ No newline at end of file

From e75955b9d9086a2abe16bc60b5c975a80643332f Mon Sep 17 00:00:00 2001
From: Matt Leary <33221468+mleary@users.noreply.github.com>
Date: Mon, 23 Mar 2026 06:35:12 -0700
Subject: [PATCH 2/2] Update, avoid duplication and point to charts/Readmes

---
 index.qmd | 50 ++++++++------------------------------------------
 1 file changed, 8 insertions(+), 42 deletions(-)

diff --git a/index.qmd b/index.qmd
index 7adaed6fe..7b08f2dc5 100644
--- a/index.qmd
+++ b/index.qmd
@@ -23,53 +23,19 @@ title: Posit Helm Charts
 
 ## Installing Charts
 
-Example instructions to install a chart for each product are below. For full installation details, see the overview page for each product.
-
-::: {.panel-tabset}
-
-### Posit Workbench
-
-```{.bash}
-kubectl create secret generic rstudio-workbench-license \
-  --from-file=licenses/rstudio-workbench.lic
-helm install workbench rstudio/rstudio-workbench \
-  --set license.file.secret=rstudio-workbench-license \
-  --set license.file.secretKey=rstudio-workbench.lic \
-  --values workbench-values.yaml
-```
-
-### Posit Connect
-
-```{.bash}
-kubectl create secret generic rstudio-connect-license \
-  --from-file=licenses/rstudio-connect.lic
-helm install connect rstudio/rstudio-connect \
-  --set license.file.secret=rstudio-connect-license \
-  --set license.file.secretKey=rstudio-connect.lic \
-  --values connect-values.yaml
-```
-
-### Posit Package Manager
-
-```{.bash}
-kubectl create secret generic rstudio-pm-license \
-  --from-file=licenses/rstudio-pm.lic
-helm install packagemanager rstudio/rstudio-pm \
-  --set license.file.secret=rstudio-pm-license \
-  --set license.file.secretKey=rstudio-pm.lic \
-  --values pm-values.yaml
-```
-
-### Posit Chronicle
+The general pattern for installing a Posit Helm chart:
 
 ```{.bash}
-helm install chronicle rstudio/posit-chronicle \
-  --values chronicle-values.yaml
+helm install <release-name> rstudio/<chart-name> \
+  --values values.yaml
 ```
 
-:::
+For product-specific installation instructions, including license configuration, see each chart's overview:
 
-You can also provide a license via `license.server` (for a license server). See each chart's values reference for details.
+- [Posit Workbench](charts/rstudio-workbench/README.md#installing-the-chart)
+- [Posit Connect](charts/rstudio-connect/README.md#installing-the-chart)
+- [Posit Package Manager](charts/rstudio-pm/README.md#installing-the-chart)
+- [Posit Chronicle](charts/posit-chronicle/README.md#installing-the-chart)
 
 ## Upgrading a Release