Clarify macOS install limitations

- Skip Docker/kind setup on macOS in install.sh
- Note Linux-only Docker/kind support in docs
- Add macOS TFTP server availability note

Author: mgarcia01752

docs/docker/install.md

@@ -1,5 +1,8 @@
 # PyPNM Docker Install & Usage
 
+Note: Docker workflows are supported on Linux hosts. macOS users should not use
+these Docker-specific instructions.
+
 PyPNM ships with Docker assets so you can run the API quickly on a workstation, lab host, or VM. This guide covers the common flows:
 
 - Install the published release image via the helper script.

docs/install/development.md

@@ -1,5 +1,8 @@
 # Development Install (Docker + kind)
 
+Note: Docker and Kubernetes workflows are supported on Linux. macOS users should not use
+the Docker/kind paths in this guide.
+
 Use this when you want a local environment that can run the release smoke tests.
 
 This option installs:

docs/kubernetes/pypnm-deploy.md

@@ -1,5 +1,8 @@
 # PyPNM on Kubernetes (kind)
 
+Note: Kubernetes (kind) workflows are supported on Linux hosts. macOS users should not
+use this guide.
+
 This walkthrough uses the manifests in `deploy/kubernetes/`. Start by installing kind and creating a cluster using [Local Kubernetes (kind) install](kind-install.md).
 
 ## Repo toolkit usage (recommended)

docs/system/pnm-file-retrieval/tftp.md

@@ -68,6 +68,9 @@ If PNM file retrieval fails with TFTP errors (for example,
 `TFTP_PNM_FILE_FETCH_ERROR` in the logs), verify:
 
 1. The TFTP service is running on `localhost` and listening on UDP port 69.
+
+Note: macOS includes a TFTP client but does not ship a native TFTP server. Use a
+third-party daemon if you need a local TFTP server on macOS.
 2. The TFTP server is allowed to **serve** files (download) as well as accept
    uploads from the cable modem. Some configurations are upload-only.
 3. The TFTP root or `remote_dir` actually contains the PNM files that the CM

install.sh

@@ -462,6 +462,11 @@ esac
 
 if [[ "$DEVELOPMENT_MODE" == "1" ]]; then
   echo "🧰 Development setup: Docker + kind/kubectl + gitleaks..."
+  if [[ "$PM" == "brew" ]]; then
+    echo "⚠️  macOS does not support the Docker/kind bootstrap in this script."
+    echo "    Skipping Docker/kind install; running gitleaks setup only."
+    install_gitleaks
+  else
   if ! command -v curl >/dev/null 2>&1; then
     if [[ "$PM" == "none" ]]; then
       echo "❌ curl not found and no package manager available."
@@ -488,6 +493,7 @@ if [[ "$DEVELOPMENT_MODE" == "1" ]]; then
   install_gitleaks
   echo "ℹ️  Docker may require: sudo systemctl start docker"
   echo "ℹ️  For non-sudo Docker: sudo usermod -aG docker \"${USER}\" (then log out/in)"
+  fi
 fi
 
 if ! command -v python3 >/dev/null 2>&1; then