From bfc63906a10180822249134cbe82f0ffc9037f11 Mon Sep 17 00:00:00 2001
From: Simone <simone.chifari@gmail.com>
Date: Mon, 8 Jun 2026 21:46:38 +0200
Subject: [PATCH] =?UTF-8?q?docs(runbook):=20show=20--gui=20variant=20in=20?=
 =?UTF-8?q?=C2=A73=20job=20example?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/RUNBOOK-PhaseC.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/docs/RUNBOOK-PhaseC.md b/docs/RUNBOOK-PhaseC.md
index 41babd7..0bb8e46 100644
--- a/docs/RUNBOOK-PhaseC.md
+++ b/docs/RUNBOOK-PhaseC.md
@@ -191,6 +191,22 @@ ci job \
   --use-git-clone
 ```
 
+The VM boots headless by default. To watch it in the Workstation GUI while it
+runs, add `--gui` (needs an X display — see [§4.7](#47-open-a-vm-in-the-workstation-gui)):
+
+```bash
+ci job \
+  --job-id manual-$(date +%s) \
+  --template-path /var/lib/ci/templates/LinuxBuild2404/LinuxBuild2404.vmx \
+  --snapshot-name BaseClean-Linux \
+  --repo-url https://gitea.emulab.it/Simone/local-ci-cd-system.git \
+  --branch main \
+  --guest-os linux \
+  --build-command "echo build-ok" \
+  --use-git-clone \
+  --gui
+```
+
 `--job-id`, `--repo-url`, `--branch`, and `--template-path` are required. The
 default `--snapshot-name` is `BaseClean`, so Linux jobs must pass
 `--snapshot-name BaseClean-Linux` explicitly. Other useful flags: