Skip to content

docs (talos hvm): add the Talos Hypervisor docs - #867

Merged
talos-bot merged 8 commits into
siderolabs:mainfrom
Iheanacho-ai:talos-hypervisor-docs
Oct 15, 2026
Merged

talos-bot merged 8 commits into
siderolabs:mainfrom
Iheanacho-ai:talos-hypervisor-docs

Conversation

@Iheanacho-ai

Copy link
Copy Markdown
Member

What

Adds the Talos Hypervisor docs section: navigation, overview, getting started (requirements, install a hypervisor host, run your first virtual machine), storage (content libraries and images, storage pools), and virtual machines (configuration, consoles). Also bumps Omni to v1.12.4 and regenerates the Talos v1.15 reference for v1.15.0-alpha.1.

Why

Talos Hypervisor ships with Talos Linux v1.15.0-alpha.1 for TalosCon. The pages link to each other and to the v1.15 configuration reference, so the broken-links check fails when they are merged separately. This PR combines them so they merge together.

Supersedes

Each PR's commit is included unchanged, and review comments from #806–#809 are already addressed in them.

Change

  • hypervisor.yaml and the generated docs.json: new Talos Hypervisor tab.
  • public/hypervisor/: eight new pages.
  • public/talos/v1.15/reference/: regenerated for v1.15.0-alpha.1, including the ContentLibraryConfig, VirtualMachineConfig, and StoragePool pages.
  • Omni reference and version variables updated to v1.12.4.

Testing

  • Ran: every procedure on the Install, Run your first virtual machine, Upload and manage images, Create a storage pool, Configure a virtual machine, and Access the virtual machine console pages, including serial and VNC consoles and cloud-init.
  • Where: a ThinkPad (amd64) hypervisor host on a v1.15.0-alpha.0 development build with the libvirtd extension.
  • By: by hand, and with an agent.
  • Result: all steps passed. Claims were also checked against the v1.15.0-alpha.1 source.
  • Not tested on a host: Image Factory image build (Step 1 of Install, now works for alpha.1), worker hosts, cloud hosts, arm64, and writable disks in storage pools (new in alpha.1, documented from source).
  • Checks run locally: make docs.json (no diff), validate-docs-nav, canonical-links-check, check-frontmatter-changed, and style-check-changed all pass, and every link from the hypervisor pages resolves.

Signed-off-by: Amarachi Iheanacho <amarachi.iheanacho@siderolabs.com>
Signed-off-by: Amarachi Iheanacho <amarachi.iheanacho@siderolabs.com>
…hine pages

Signed-off-by: Amarachi Iheanacho <amarachi.iheanacho@siderolabs.com>
Signed-off-by: Amarachi Iheanacho <amarachi.iheanacho@siderolabs.com>
Signed-off-by: Amarachi Iheanacho <amarachi.iheanacho@siderolabs.com>
Signed-off-by: Amarachi Iheanacho <amarachi.iheanacho@siderolabs.com>
@talos-bot talos-bot moved this from To Do to In Review in Planning Oct 13, 2026
@github-project-automation github-project-automation Bot moved this from In Review to Approved in Planning Oct 15, 2026
Comment thread public/hypervisor/getting-started/install-a-hypervisor-host.mdx Outdated
Comment thread public/hypervisor/getting-started/install-a-hypervisor-host.mdx Outdated
Comment thread public/hypervisor/virtual-machines/access-the-virtual-machine-console.mdx Outdated
sterlingkoch and others added 2 commits October 15, 2026 03:30
Co-authored-by: sterlingkoch <sterlingkoch@users.noreply.github.com>
Signed-off-by: sterlingkoch <sterlingkoch@users.noreply.github.com>
Signed-off-by: Sterling Koch <sterling.koch@siderolabs.com>
@sterlingkoch

Copy link
Copy Markdown
Member

/m

This branch was successfully deployed

1 active deployment
staging - public — 13a674e6 Deployed Oct 15, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

3 participants