From b9360c1008519275c69c403ddd0a8f1612806ff2 Mon Sep 17 00:00:00 2001
From: openoms <oms@tuta.io>
Date: Mon, 15 Jul 2024 17:48:39 +0200
Subject: [PATCH] docs: clarify jam remote steps

---
 scripts/jam-remote/README.md | 45 ++++++++++++++++++++----------------
 1 file changed, 25 insertions(+), 20 deletions(-)

diff --git a/scripts/jam-remote/README.md b/scripts/jam-remote/README.md
index ed49029..9a73427 100644
--- a/scripts/jam-remote/README.md
+++ b/scripts/jam-remote/README.md
@@ -1,33 +1,38 @@
 # Install Jam and connect to a remote Joininbox
 
-* tested on Debian Bullseye desktop - Ubuntu should also work
+* tested on Debian Bullseye and Bookworm desktop - Ubuntu should also work
 
+## Steps in your Joininbox terminal
+* (optional) update the joininbox scripts: `UPDATE` - `ADVANCED` - `JBCOMMIT`
+* start the `API` from `TOOLS`
+* (optional) start the ob-watcher from `OFFERS`
+
+## Steps on your desktop
 ### Download the repo
-```
-git clone https://github.com/openoms/joininbox
-cd joininbox
-```
+* move to a directory where the joininbox repo will be stored
+  ```
+  git clone https://github.com/openoms/joininbox
+  cd joininbox
+  ```
 
 ### Install Jam locally
 * will be under the user: `jam`
-```
-cd scripts/jam-remote
-bash install.jam.sh on
-```
-
-### On your Joininbox
-* (optional) update the joininbox scripts: `UPDATE` - `ADVANCED` - `JBCOMMIT`
-* start the `API` from `TOOLS`
-* (optional) start the ob-watcher from `OFFERS`
+  ```
+  cd scripts/jam-remote
+  bash install.jam.sh on
+  ```
 
 ### Forward the API and ob-watcher ports with ssh from your Joininbox
-```
-bash ssh-portforward $JOININBOX_LAN_IP
-```
+* run the ssh-port-forward script in the `joininbox/scripts/jam-remote` folder
+  ```
+  bash ./ssh-port-forward.sh $JOININBOX_LAN_IP
+  ```
 * leave this terminal open until working with Jam
 * close when done to close the ssh connection
-* Earn will continue to run on the Joininbox
-* can check it's logs in the menu - `MAKER` - `LOGS`
 
 ### Open Jam locally using the wallets on your remote Joininbox
-`https://localhost:7501`
+* open Jam at https://localhost:7501
+* accept the self-signed certificate served from your Joininbox
+* Use Jam - docs: https://jamdocs.org/
+* Earn will continue to run on the Joininbox even after the terminal and Jam windows are closed
+* can check the logs in the Joininbox menu - `MAKER` - `LOGS`