From 5973331f648e896a58b5ba0227e3a75c35ad864c Mon Sep 17 00:00:00 2001
From: constantprojects <jack@Jacks-MacBook-Pro-4.local>
Date: Tue, 24 Feb 2026 08:38:33 -0700
Subject: [PATCH] Add progress descriptions to install.sh for slow connections

Each major install step now shows what it does and how long to expect:
- System update: 2-10 min on fresh servers
- Security tools: under a minute
- Docker: 1-3 min (largest download)
- Clone: a few seconds

Updated guide.md terminal output to match.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 guide.md   | 8 +++++++-
 install.sh | 8 +++++++-
 2 files changed, 14 insertions(+), 2 deletions(-)

diff --git a/guide.md b/guide.md
index 12b9ee3..03072d3 100644
--- a/guide.md
+++ b/guide.md
@@ -198,8 +198,11 @@ Detected: ubuntu 22.04
   Securing your server...
 ───────────────────────────────────────────────────────────
 Updating system packages...
+  Downloading the latest security patches for your operating system.
+  On a fresh server this can take 2-10 minutes. Sit tight.
 System packages updated.
-Installing firewall, fail2ban, and automatic updates...
+Installing security tools (firewall, fail2ban, auto-updates)...
+  These protect your server from common attacks. Usually under a minute.
 Configuring firewall...
 Firewall enabled: SSH, HTTP, and HTTPS allowed. All other ports blocked.
 Fail2ban enabled: brute-force SSH protection active.
@@ -213,8 +216,11 @@ Docker log rotation configured (10MB max per log, 3 files per container).
     Docker log limits: configured (30MB max per container)
 
 Installing Docker...
+  Docker packages and runs your website in isolated containers.
+  This is the largest download — usually takes 1-3 minutes.
 Docker installation complete.
 Cloning WebsiteBox...
+  Downloading the project files from GitHub. Just a few seconds.
 
 ═══════════════════════════════════════════════════════════
   WebsiteBox Setup Wizard
diff --git a/install.sh b/install.sh
index cbe31ca..9e07839 100755
--- a/install.sh
+++ b/install.sh
@@ -72,12 +72,15 @@ echo "────────────────────────
 
 # Update system packages
 echo "Updating system packages..."
+echo "  Downloading the latest security patches for your operating system."
+echo "  On a fresh server this can take 2-10 minutes. Sit tight."
 $SUDO apt-get update -qq
 $SUDO apt-get upgrade -y -qq
 echo "System packages updated."
 
 # Install firewall, fail2ban, and automatic updates
-echo "Installing firewall, fail2ban, and automatic updates..."
+echo "Installing security tools (firewall, fail2ban, auto-updates)..."
+echo "  These protect your server from common attacks. Usually under a minute."
 $SUDO apt-get install -y -qq ufw fail2ban unattended-upgrades
 
 # Configure firewall — allow SSH first to avoid lockout
@@ -147,6 +150,8 @@ if command -v docker &>/dev/null; then
     echo "Docker is already installed."
 else
     echo "Installing Docker..."
+    echo "  Docker packages and runs your website in isolated containers."
+    echo "  This is the largest download — usually takes 1-3 minutes."
 
     # Install prerequisites
     $SUDO apt-get update -qq
@@ -197,6 +202,7 @@ if [ -d "$INSTALL_DIR" ]; then
     git pull || true
 else
     echo "Cloning WebsiteBox..."
+    echo "  Downloading the project files from GitHub. Just a few seconds."
     git clone https://github.com/websitebox/websitebox.git "$INSTALL_DIR"
     cd "$INSTALL_DIR"
 fi