docs

Author: AlchemiistCreative

docs/getting-started.md

@@ -1,32 +1,90 @@
 # Getting Started (Developer Preview)
 
-> ⚠️ **Active Development:** OpenHVX is not production‑ready. This guide targets **contributors and early testers**.
+> ⚠️ **Active Development:** OpenHVX is not production-ready. This guide targets **contributors and early testers**.
+
+---
 
 ## Prerequisites
 
-- Windows host with **Hyper‑V** (for Agent tests)
+- Windows host with **Hyper-V** (for Agent tests)
 - **Docker/Podman & Docker Compose**
 - **Node.js 20+** and **npm**
 - **Go 1.21+** (to build Agent tools)
 
+---
+
 ## Quick Start (Backend)
 
 ```bash
 # 1) Clone
 git clone https://github.com/openhvx/openhvx-backend.git
 cd openhvx-backend
-# 2) Env
-Create and fill env files (.env.auth, .env.controller, .env.gateway, .env.ws)
+
+# 2) Environment
+# Create and fill env files:
+#   .env.auth, .env.controller, .env.gateway, .env.ws
+
 # 3) Run services
 docker compose up -d
-
 ```
 
 > **All variables and examples are documented in** [Environment variables](https://openhvx.org/docs/environment-variables.html).
 
+---
+
+## Create a Global Admin (one-time bootstrap)
+
+This initializes the **platform-wide administrator** via the Admin Auth API.
+
+> **Notes**
+>
+> - Requires `REGISTER_ENABLED=true` and a valid `REGISTER_API_KEY` on the **Auth** side.
+> - The `mode` parameter defines the registration behavior:
+>   - `once`: create only if missing (409 if already exists)
+>   - `reset`: reset password only if user exists
+>   - `upsert`: create if missing, or reset if exists (recommended for bootstrap)
+> - Replace `x-api-key` and credentials as needed.
+
+### Linux / macOS
+
+```bash
+curl -k -X POST "https://admin-api.openhvx.local/api/v1/admin/auth/register?mode=upsert" \
+  -H "content-type: application/json" \
+  -H "x-api-key: example" \
+  --data-binary '{"email":"admin@openhvx.local","password":"3x4mpl3"}'
+```
+
+### Windows PowerShell
+
+```powershell
+curl -k -Method POST "https://admin-api.openhvx.local/api/v1/admin/auth/register?mode=upsert" `
+  -Headers @{ "content-type" = "application/json"; "x-api-key" = "Fklzhrfolzhrihjzpo" } `
+  -Body '{ "email":"admin@openhvx.local", "password":"3x4mpl3" }'
+```
+
+**Expected response (example):**
+
+```json
+{
+  "ok": true,
+  "user": {
+    "id": "adm_01J....",
+    "email": "admin@openhvx.local",
+    "role": "global-admin"
+  }
+}
+```
+
+> **Security**
+>
+> - Avoid exposing the API key in your shell history: export it to a variable (`export ADMIN_REGISTER_KEY=...`) and use `-H "x-api-key: $ADMIN_REGISTER_KEY"`.
+> - Change the password and registration key in real environments.
+
+---
+
 ## Build Agent Tools (Windows helpers)
 
-These binaries are required by the PowerShell Agent to create cloud‑init ISOs and to bridge serial consoles.
+These binaries are required by the PowerShell Agent to create **cloud-init ISOs** and to bridge **serial consoles**.
 
 **Layout:**
 
@@ -53,7 +111,9 @@ This will:
 
 > If you build manually, ensure you build `src/` first, then the tools, then move outputs to `/src/powershell/bin`.
 
-## Running the Agent (on a Hyper‑V host)
+---
+
+## Running the Agent (on a Hyper-V host)
 
 1. Copy the folder `src/powershell/` and its `bin/` subfolder (containing the built `.exe`) to the Windows host.
 2. Open an elevated PowerShell.
@@ -86,8 +146,10 @@ This will:
 # .\openhvx-agent.exe
 ```
 
+---
+
 ## Next Steps
 
 - Read: **Overview → Architecture & Features**
-- Contribute: open issues/PRs on GitHub: [https://github.com/openhvx](https://github.com/openhvx)
+- Contribute: open issues/PRs on GitHub → [https://github.com/openhvx](https://github.com/openhvx)
 - Roadmap & known limitations: _(coming soon)_

docs/index.md

@@ -6,6 +6,8 @@ OpenHVX is an open-source orchestration platform for **multi-tenant Hyper-V infr
 > Expect rapid iteration and potential breaking changes between releases.
 > Community testing and contributions are highly encouraged!
 
+---
+
 ## Architecture
 
 OpenHVX separates orchestration and execution into clear layers.
@@ -39,6 +41,25 @@ The design emphasizes **asynchronous communication**, **tenant isolation**, and
 
 ---
 
+## User Interface
+
+### Admin Dashboard
+
+The admin dashboard provides a global overview of tenants, resources, and running tasks.
+
+<img src="/assets/dashboard.png" alt="OpenHVX Admin Dashboard" width="900" data-zoomable />
+
+### Serial Console
+
+Each VM exposes a live serial console, **established as a tunnel** between the **client browser** and the **Agent**, with the **WebSocket Broker** acting as an intermediary relay.  
+The broker maintains secure, tenant-scoped channels, ensuring that only authenticated users can attach to their own virtual machines.
+
+This architecture provides near real-time console streaming, independent of the hypervisor’s native UI or RDP, and works even in fully headless environments.
+
+<img src="/assets/serial-console.png" alt="OpenHVX Serial Console" width="900" data-zoomable />
+
+---
+
 ### 🤝 Contributing
 
 We welcome contributions from the community! Whether it’s documentation improvements, feature suggestions, or bug reports — every input helps make OpenHVX better. Visit the [GitHub organization](https://github.com/openhvx) to get started.

docs/public/assets/dashboard.png

@@ -223,7 +223,7 @@ <h3 class="tl-title">Core Backend · MVP</h3>
         <div class="tl-foot"></div>
       </li>
 
-      <li class="tl-item in-progress">
+      <li class="tl-item done">
         <span class="tl-dot" aria-hidden="true"></span>
         <time class="tl-time">Q1 2026</time>
         <h3 class="tl-title">Quota System</h3>