# Install guide — all operating systems (Gold Master)

**DBAOps Sovereign™** · **RHOYLLE INNOVATION EMPIRE LLC**

Three supported paths: **guided setup (Node)**, **shell scripts (Unix)**, **Docker (every OS)**.

**Install every prerequisite (OS-level):** **`docs/INSTALL-REQUIREMENTS.md`** — run **`npm run install:requirements`** (forwards flags to the OS script) or **`.\scripts\install-requirements.ps1`** / **`./scripts/install-requirements.sh`**.

---

## Prerequisites

| Requirement | Notes |
|-------------|--------|
| **Node.js 18+** | Required for API and dashboard development/build. |
| **npm** | Bundled with Node. |
| **Docker Desktop** (optional) | Recommended for identical installs on **Windows, macOS, and Linux**. |
| **SQL Server** (optional) | For production data; omit for evaluation (mock mode) or use Docker SQL separately. |

Automated installs: see **`docs/INSTALL-REQUIREMENTS.md`** (winget, Homebrew, apt/NodeSource, plus official vendor download links).

---

## Path A — One guided setup (simplest)

From the **repository root**:

```bash
npm install
npm run setup
```

Then:

| Goal | Command |
|------|---------|
| **Development** — API + hot-reload dashboard | `npm start` |
| **Production build** | `npm run build` |
| **Migrate database** (SQL configured in `.env`) | `npm run migrate` |
| **Docker — full stack** | `npm run docker:up` → http://localhost:3000 |

**Windows** users can still use `.\scripts\run.ps1` after setup.

---

## Path B — macOS, Linux, WSL, Git Bash

Make scripts executable once:

```bash
chmod +x scripts/*.sh
./scripts/install.sh     # optional — npm install
./scripts/run.sh         # API + dashboard (dev)
./scripts/build.sh
./scripts/migrate.sh
```

---

## Path C — Docker (same experience on all OS)

**Evaluation stack** (API + Fleet Command UI, development-mode API inside container):

```bash
docker compose -f docker-compose.all-in-one.yml up --build
```

- **Dashboard:** http://localhost:3000  
- **API:** http://localhost:3041  
- Override API URL for the built UI if needed: `REACT_APP_API_URL=http://host:3041 docker compose -f docker-compose.all-in-one.yml up --build`

**Production hardening:** set `NODE_ENV=production`, a strong `JWT_SECRET`, `SOVEREIGN_INGEST_KEY`, and `SOVEREIGN_REQUIRE_AUTH=true` in `.env` and pass them into compose — see **`docs/CUSTOMER-DEPLOYMENT.md`** and **`delivery/SECURITY-HARDENING.md`**.

---

## Collectors

**PowerShell** collectors target **Windows** (or PowerShell Core on Linux **if** you install it and SQL connectivity). For market messaging: primary collector story is **Windows SQL** hosts; cross-platform agents can follow without changing the core API.

---

## Verification (Gold Master)

With API running:

```bash
API_BASE=http://127.0.0.1:3041 npm run verify:smoke
```

---

## Pilot & testing package (before the public website)

The **single folder** for internal QA, pilot handoff, and legal review **before** posting to your website:

1. From repo root: **`npm run package:enterprise`** (same as **`npm run package:pilot`**).
2. Open **`pilot-before-website/START-HERE.md`**, then the generated **`pilot-before-website/DBAOps-Sovereign-<VERSION>-enterprise/`** tree.

---

## Trademark

Use **DBAOps Sovereign™** and credit **RHOYLLE INNOVATION EMPIRE LLC** per **`delivery/TRADEMARK-AND-BRAND.md`**.

---

© 2026 RHOYLLE INNOVATION EMPIRE LLC.
