From aff7a3094f28beacc48012f6ac0590556a9bd628 Mon Sep 17 00:00:00 2001
From: David Aronchick <aronchick@gmail.com>
Date: Sat, 20 Jun 2026 15:17:24 -0700
Subject: [PATCH] Add single-node demo inventory

---
 deploy/inventory.single-node/group_vars/all   |  5 ++
 deploy/inventory.single-node/groups/edge      |  2 +
 .../host_vars/demo-edge-01                    |  6 ++
 docs/single-node-demo.md                      | 58 +++++++++++++++++++
 4 files changed, 71 insertions(+)
 create mode 100644 deploy/inventory.single-node/group_vars/all
 create mode 100644 deploy/inventory.single-node/groups/edge
 create mode 100644 deploy/inventory.single-node/host_vars/demo-edge-01
 create mode 100644 docs/single-node-demo.md

diff --git a/deploy/inventory.single-node/group_vars/all b/deploy/inventory.single-node/group_vars/all
new file mode 100644
index 0000000..d8c40ba
--- /dev/null
+++ b/deploy/inventory.single-node/group_vars/all
@@ -0,0 +1,5 @@
+# Single-node demo defaults.
+#
+# Override these values if the demo should track a different release.
+expanso_edge_channel: stable
+expanso_edge_version: v2.1.18
diff --git a/deploy/inventory.single-node/groups/edge b/deploy/inventory.single-node/groups/edge
new file mode 100644
index 0000000..e77637b
--- /dev/null
+++ b/deploy/inventory.single-node/groups/edge
@@ -0,0 +1,2 @@
+hosts:
+  - demo-edge-01
diff --git a/deploy/inventory.single-node/host_vars/demo-edge-01 b/deploy/inventory.single-node/host_vars/demo-edge-01
new file mode 100644
index 0000000..c3dbe0b
--- /dev/null
+++ b/deploy/inventory.single-node/host_vars/demo-edge-01
@@ -0,0 +1,6 @@
+# Replace these values with a Debian, Ubuntu, or EL host reachable from the
+# machine running Jetpack.
+hostname: demo-edge-01
+jet_ssh_hostname: CHANGE_ME
+jet_ssh_user: root
+jet_ssh_port: 22
diff --git a/docs/single-node-demo.md b/docs/single-node-demo.md
new file mode 100644
index 0000000..246fac5
--- /dev/null
+++ b/docs/single-node-demo.md
@@ -0,0 +1,58 @@
+# Single-Node Demo
+
+Use this path when you already have one Debian, Ubuntu, or EL host reachable by
+SSH and want the fastest demo of the `expanso-edge` role without provisioning a
+Proxmox fleet.
+
+## 1. Point the inventory at your host
+
+Edit `deploy/inventory.single-node/host_vars/demo-edge-01`:
+
+```yaml
+hostname: demo-edge-01
+jet_ssh_hostname: 192.0.2.10
+jet_ssh_user: root
+jet_ssh_port: 22
+```
+
+Use a real IP address or DNS name for `jet_ssh_hostname`. If your SSH key is not
+loaded in the agent, pass Jetpack the key file on the command line.
+
+## 2. Add the Expanso bootstrap token
+
+Copy the secret overlay and replace the placeholder bootstrap key:
+
+```bash
+cp -r deploy/secrets.example deploy/secrets
+$EDITOR deploy/secrets/group_vars/edge
+```
+
+The value should be an Expanso Cloud bootstrap key:
+
+```yaml
+expanso_bootstrap_token: "exp_bk_..."
+```
+
+## 3. Validate the demo inventory
+
+```bash
+jetp inventory-check --inventory deploy/inventory.single-node:deploy/secrets
+
+jetp full-check \
+  --playbook deploy/playbooks/expanso-edge.yml \
+  --inventory deploy/inventory.single-node:deploy/secrets \
+  --roles deploy/roles
+```
+
+## 4. Deploy the agent
+
+```bash
+jetp ssh \
+  --playbook deploy/playbooks/expanso-edge.yml \
+  --inventory deploy/inventory.single-node:deploy/secrets \
+  --roles deploy/roles \
+  --limit-hosts demo-edge-01
+```
+
+The role installs the configured `expanso-edge` release, bootstraps the host to
+Expanso Cloud, installs the systemd unit, and starts the service.