From a31805418ec48f143546e2932547d9369d262ed5 Mon Sep 17 00:00:00 2001
From: Bryan Roscoe <bryanroscoe@gmail.com>
Date: Fri, 8 May 2026 16:21:12 -0500
Subject: [PATCH 1/2] Document Docker usage for Linux

Adds an Installation subsection covering how to run the script inside
Microsoft's official PowerShell container on Linux. Calls out the two
non-obvious requirements (--network host, iproute2) and notes the
Docker Desktop limitation on macOS/Windows where host networking is
unavailable.

Closes #9
---
 README.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/README.md b/README.md
index 76dc388..fa6632a 100644
--- a/README.md
+++ b/README.md
@@ -102,6 +102,22 @@ sudo apt-get install -y powershell
 pwsh ./Shield-Optimizer.ps1
 ```
 
+### Linux (Docker)
+
+If you'd rather not install PowerShell on your host, you can run the script inside Microsoft's official PowerShell container. `--network host` is required so the script can scan your LAN for devices, and `iproute2` is needed inside the container for the auto-discovery scan.
+
+```bash
+# Start an interactive PowerShell container on the host network
+docker run -it --rm --network host mcr.microsoft.com/powershell:latest
+
+# Inside the container:
+apt-get update && apt-get install -y iproute2
+Invoke-WebRequest -Uri https://github.com/bryanroscoe/shield_optimizer/raw/refs/heads/main/Shield-Optimizer.ps1 -OutFile Shield-Optimizer.ps1
+./Shield-Optimizer.ps1
+```
+
+> **Note:** `--network host` only works on native Linux. On Docker Desktop for macOS/Windows, auto-discovery won't see your LAN — install PowerShell natively (see above) or use the script's **Connect IP** option to enter your device's IP manually.
+
 ## Download
 
 **Option 1: Download from Releases (Recommended)**

From 435c51158d017405b6d75f6db30c499c8aa6d0ff Mon Sep 17 00:00:00 2001
From: Bryan Roscoe <bryanroscoe@gmail.com>
Date: Fri, 8 May 2026 16:25:45 -0500
Subject: [PATCH 2/2] Note Docker workflow is not yet verified end-to-end

---
 README.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/README.md b/README.md
index fa6632a..4cccebc 100644
--- a/README.md
+++ b/README.md
@@ -104,6 +104,8 @@ pwsh ./Shield-Optimizer.ps1
 
 ### Linux (Docker)
 
+> *Should work, but not verified end-to-end.* Based on the workflow @shawly reported in [#9](https://github.com/bryanroscoe/shield_optimizer/issues/9).
+
 If you'd rather not install PowerShell on your host, you can run the script inside Microsoft's official PowerShell container. `--network host` is required so the script can scan your LAN for devices, and `iproute2` is needed inside the container for the auto-discovery scan.
 
 ```bash