From 5cb3b7ae2b9602593f567a298ec10a368f9f613b Mon Sep 17 00:00:00 2001
From: Shadowbroker <43977454+BigBodyCobain@users.noreply.github.com>
Date: Fri, 13 Mar 2026 12:47:53 -0600
Subject: [PATCH] Update README.md

Former-commit-id: b443fc94edb2a15fe49769f84dcf319c18503dfa
---
 README.md | 67 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 67 insertions(+)

diff --git a/README.md b/README.md
index d40775c..7507d84 100644
--- a/README.md
+++ b/README.md
@@ -60,6 +60,73 @@ Do not append a trailing `.` to that command; Compose treats it as a service nam
 
 ---
 
+##  🛠️ How to Update Shadowbroker
+To update to the latest version, follow the steps for your specific Operating System.
+
+🐧 Linux & 🍎 macOS (Terminal / Zsh / Bash)
+Since these systems are Unix-based, you can use the helper script directly.
+
+Pull the latest code:
+```bash
+git pull origin main
+```
+Run the update script:
+```bash
+./compose.sh down
+./compose.sh up --build -d
+```
+
+🪟 Windows (Command Prompt or PowerShell)
+Windows handles scripts differently. You have two ways to update:
+
+Method A: The Direct Way (Recommended)
+Use the docker compose commands directly. This works in any Windows terminal (CMD, PowerShell, or Windows Terminal).
+
+Pull the latest code:
+```bash
+git pull origin main
+```
+
+Rebuild the containers:
+```bash
+docker compose down
+docker compose up --build -d
+```
+
+Method B: Using the Script (Git Bash)
+If you prefer using the ./compose.sh script on Windows, you must use Git Bash (installed with Git for Windows).
+
+Open your project folder, Right-Click, and select "Open Git Bash here".
+
+Run the Linux commands:
+```bash
+./compose.sh down
+./compose.sh up --build -d
+```
+---
+
+⚠️ Troubleshooting the Build
+If you still see the old version after updating:
+
+Force a clean build: 
+```bash
+docker compose build --no-cache
+```
+
+Check logs for errors: 
+```bash
+docker compose logs -f backend
+```
+
+Prune old images: 
+```bash
+docker image prune -f
+```
+
+Open `http://localhost:3000` to view the dashboard! *(Requires Docker or Podman)*
+
+---
+
 ## ✨ Features
 
 ### 🛩️ Aviation Tracking