Ty
e5e179e541
Operator can run make bootstrap/install through S2 using nemohermes/openshell wrappers; docs and implement queue updated. No S3+ and no push.
56 lines
2.0 KiB
Markdown
56 lines
2.0 KiB
Markdown
# 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.
|