# Deployer host baselining

**Status:** Procedural — ready for operator use.

## Purpose

Create a clean host that can run the Docker-based Lumina stack. This product is **repo-driven**, not tied to one developer's existing Hermes install.

## Requirements

| Item | Spec |
|------|------|
| OS | Linux x86_64 or arm64 (cloud VM, bare metal; WSL2 optional path only) |
| Resources | Multi-core CPU; ≥8–16 GB RAM recommended; disk for Docker images |
| Privileges | User able to install Docker / run Compose (sudo access) |
| Network | Outbound HTTPS to model endpoint, SaaS APIs, MCP remotes, image registry |
| GPU | Optional; only if local VLM is used (not required if vision is remote) |

## Prerequisites (before running scripts)

1. **Provision host** — cloud console, hypervisor, or bare metal.
2. **Install base OS updates** — `sudo apt update && sudo apt upgrade -y` (Debian/Ubuntu) or equivalent.
3. **Create deploy user** — a non-root user with sudo access.
4. **Install NemoClaw CLIs** — `nemohermes` and `openshell` must be on PATH. See [NemoClaw docs](https://docs.nvidia.com/nemoclaw/latest/user-guide/hermes/reference/architecture.md) for installation.
5. **Clone this repository** — `git clone <repo-url> && cd Salon_Assistant`.

## Bootstrap (S0b)

Run the bootstrap script to install Docker if missing:

```bash
./scripts/bootstrap.sh
```

Or via Make:

```bash
make bootstrap
```

**What it does:**
- Detects if Docker is already installed and running (idempotent).
- If missing, installs Docker via the official convenience script (Debian/Ubuntu) or dnf (RHEL/Fedora).
- Adds the current user to the `docker` group.
- Verifies the Docker daemon is reachable.

**If Docker is already present:** the script detects it and exits immediately with a success message.

## Continue with install

After bootstrap, proceed to [INSTALL.md](INSTALL.md) for stages S1–S2.

## Design reference

[design/DESIGN_PLAN.md](../design/DESIGN_PLAN.md) §4 Docker packaging and install stages.