# Install all prerequisites — DBAOps Sovereign™

**RHOYLLE INNOVATION EMPIRE LLC**

This document lists **every runtime requirement**, how to install it **automatically** (where supported), and **official vendor installers** when you prefer manual setup or winget/brew is unavailable.

| Requirement | Required for | Automated (script) | Manual installer |
|-------------|--------------|--------------------|------------------|
| **Node.js 18+** + **npm** | API, dashboard, `npm run setup` | Windows: `scripts/install-requirements.ps1` · macOS/Linux: `scripts/install-requirements.sh` | [Node.js LTS](https://nodejs.org/) |
| **Docker Desktop** (optional) | `npm run docker:up`, identical stack all OS | Same scripts with `--WithDocker` / `-IncludeDocker` | [Docker Desktop](https://www.docker.com/products/docker-desktop/) |
| **SQL Server 2022+** (optional) | Production `SovereignRepository`; skip for mock/eval | Windows: optional `-IncludeSqlExpress` (winget, large) | [SQL Server downloads](https://www.microsoft.com/sql-server/sql-server-downloads) |
| **PowerShell 7+** (optional) | Windows collectors, some `scripts/*.ps1` on PS7 | Windows: `-IncludePowerShell7` | [PowerShell install](https://learn.microsoft.com/powershell/scripting/install/installing-powershell) |
| **Git** (optional) | Clone, dev workflow | Windows: `-IncludeGit` | [Git for Windows](https://git-scm.com/download/win) |

---

## Quick commands (from repository root)

**Windows (elevated PowerShell recommended for winget):**

```powershell
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass -Force
.\scripts\install-requirements.ps1                    # Node LTS + npm (minimum)
.\scripts\install-requirements.ps1 -IncludeDocker       # + Docker Desktop
.\scripts\install-requirements.ps1 -IncludePowerShell7  # + PowerShell 7 (collectors)
.\scripts\install-requirements.ps1 -IncludeGit          # + Git
.\scripts\install-requirements.ps1 -IncludeSqlExpress   # + SQL Server 2022 Express (large; admin)
```

**macOS (Homebrew):**

```bash
chmod +x scripts/install-requirements.sh
./scripts/install-requirements.sh              # Node via brew
./scripts/install-requirements.sh --with-docker
```

**Linux (Ubuntu/Debian-style; uses sudo):**

```bash
chmod +x scripts/install-requirements.sh
./scripts/install-requirements.sh --yes        # Node 20 via NodeSource + npm
./scripts/install-requirements.sh --yes --with-docker
```

**npm (any OS — forwards extra args to the script):**

```bash
npm run install:requirements
npm run install:requirements -- -IncludeDocker -IncludeGit
npm run install:requirements -- --with-docker --yes
```

**Windows-only shortcut:**

```powershell
npm run install:requirements:win
```

After prerequisites: **`npm run setup`** then **`npm start`** (see **`docs/INSTALL-CROSS-PLATFORM.md`**).

If **SQL Server** winget id fails on your channel, run **`winget search Microsoft SQL`** and install manually from [SQL Server downloads](https://www.microsoft.com/sql-server/sql-server-downloads).

---

## Notes

1. **Close and reopen** your terminal after winget installs Node so `PATH` picks up `node` and `npm`.
2. **Docker Desktop** requires virtualization enabled (BIOS/WSL2 on Windows).
3. **SQL Server Express** is optional; evaluation can use **mock mode** without SQL. Production: set **`SOVEREIGN_DB_CONNECTION`** in `.env` after SQL is installed.
4. Trademarks: **DBAOps Sovereign™** — **`delivery/TRADEMARK-AND-BRAND.md`**.

---

© 2026 RHOYLLE INNOVATION EMPIRE LLC.
