Add OrbStack support as recommended container runtime

Runtime detection in bootstrap.sh and health-check.sh auto-detects
OrbStack vs Docker Desktop. Docs updated to list both options with
OrbStack recommended. Also resolves SETUP.md merge conflicts.

Author: liamvibecodes

README.md

@@ -9,6 +9,7 @@
   <sub>Automatically find, download, and organize movies and TV shows.<br>Browse a Netflix-like interface, click what you want, and it handles the rest.</sub>
   <br><br>
   <img src="https://img.shields.io/badge/Docker-2496ED?style=flat-square&logo=docker&logoColor=white" />
+  <img src="https://img.shields.io/badge/OrbStack-000000?style=flat-square&logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMjQiIGhlaWdodD0iMjQiIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj48Y2lyY2xlIGN4PSIxMiIgY3k9IjEyIiByPSIxMCIgZmlsbD0id2hpdGUiLz48L3N2Zz4=&logoColor=white" />
   <img src="https://img.shields.io/badge/Plex-EBAF00?style=flat-square&logo=plex&logoColor=white" />
   <img src="https://img.shields.io/badge/Sonarr-00CCFF?style=flat-square&logo=sonarr&logoColor=white" />
   <img src="https://img.shields.io/badge/Radarr-FFC230?style=flat-square&logo=radarr&logoColor=black" />
@@ -26,7 +27,7 @@ There are dozens of *arr stack Docker Compose repos on GitHub. Almost all of the
 
 - **One command to install.** Clone, configure, and start everything with a single `curl | bash`. No 45-minute manual setup.
 - **Auto-configures itself.** The configure script wires up Radarr, Sonarr, Prowlarr, Seerr, and qBittorrent via their APIs. No clicking through 6 different web UIs.
-- **Built for macOS.** Native paths, launchd instead of systemd, Docker Desktop instead of bare Docker. Not a Linux guide with "should work on Mac" in the footnotes.
+- **Built for macOS.** Native paths, launchd instead of systemd, OrbStack or Docker Desktop instead of bare Docker. Not a Linux guide with "should work on Mac" in the footnotes.
 - **Self-healing.** Hourly health checks restart anything that goes down. VPN drops, container crashes, stalled downloads — handled automatically.
 
 ---
@@ -49,13 +50,15 @@ There are dozens of *arr stack Docker Compose repos on GitHub. Almost all of the
 ## Requirements
 
 - macOS (any recent version)
-- Docker Desktop
+- [OrbStack](https://orbstack.dev) (recommended) or [Docker Desktop](https://www.docker.com/products/docker-desktop/)
 - A Plex account (free)
 - ProtonVPN WireGuard credentials
 
+> **Why OrbStack?** It starts in ~2 seconds (vs 30s for Docker Desktop), uses ~1GB RAM (vs 4GB), and has 2-10x faster file I/O. It's a drop-in replacement that runs the same Docker commands. Docker Desktop works fine too.
+
 ## One-Command Install
 
-Requires Docker Desktop and Plex already installed. Handles everything else.
+Requires OrbStack (or Docker Desktop) and Plex already installed. Handles everything else.
 
 ```bash
 curl -fsSL https://raw.githubusercontent.com/liamvibecodes/mac-media-stack/main/bootstrap.sh | bash

bootstrap.sh

@@ -16,14 +16,33 @@ echo "  Mac Media Stack Installer"
 echo "=============================="
 echo ""
 
-# Check Docker
+# Detect container runtime
+detect_runtime() {
+    if [[ -d "/Applications/OrbStack.app" ]] || command -v orbstack &>/dev/null; then
+        echo "OrbStack"
+    elif [[ -d "/Applications/Docker.app" ]]; then
+        echo "Docker Desktop"
+    else
+        echo "none"
+    fi
+}
+
+RUNTIME=$(detect_runtime)
+
 if ! docker info &>/dev/null; then
-    echo -e "${RED}Docker Desktop is not running.${NC}"
-    echo "Install it from https://www.docker.com/products/docker-desktop/"
-    echo "Open it, wait for it to start, then run this again."
+    if [[ "$RUNTIME" == "none" ]]; then
+        echo -e "${RED}No container runtime found.${NC}"
+        echo ""
+        echo "Install one of these:"
+        echo "  OrbStack (recommended):  brew install orbstack"
+        echo "  Docker Desktop:          https://www.docker.com/products/docker-desktop/"
+    else
+        echo -e "${RED}$RUNTIME is not running.${NC}"
+        echo "Open $RUNTIME, wait for it to start, then run this again."
+    fi
     exit 1
 fi
-echo -e "${GREEN}OK${NC}  Docker Desktop is running"
+echo -e "${GREEN}OK${NC}  $RUNTIME is running"
 
 # Check Plex
 if [[ -d "/Applications/Plex Media Server.app" ]] || pgrep -x "Plex Media Server" &>/dev/null; then

scripts/health-check.sh

@@ -31,14 +31,26 @@ check_service() {
     fi
 }
 
-# Check Docker is running
+# Detect container runtime
+detect_runtime() {
+    if [[ -d "/Applications/OrbStack.app" ]] || command -v orbstack &>/dev/null; then
+        echo "OrbStack"
+    elif [[ -d "/Applications/Docker.app" ]]; then
+        echo "Docker Desktop"
+    else
+        echo "Docker"
+    fi
+}
+
+RUNTIME=$(detect_runtime)
+
 if docker info &>/dev/null; then
-    echo -e "  ${GREEN}OK${NC}  Docker Desktop"
+    echo -e "  ${GREEN}OK${NC}  $RUNTIME"
     ((PASS++))
 else
-    echo -e "  ${RED}FAIL${NC}  Docker Desktop (not running)"
+    echo -e "  ${RED}FAIL${NC}  $RUNTIME (not running)"
     echo ""
-    echo "Start Docker Desktop from your Applications folder and try again."
+    echo "Start $RUNTIME and try again."
     exit 1
 fi
 
@@ -107,7 +119,7 @@ echo ""
 
 if [[ $FAIL -gt 0 ]]; then
     echo "Something's not right. Check the FAIL items above."
-    echo "Most common fix: restart Docker Desktop and wait 30 seconds."
+    echo "Most common fix: restart your container runtime (OrbStack or Docker Desktop) and wait 30 seconds."
     exit 1
 else
     echo "Everything looks good!"