Skip to content

docs: add Coming from VMware, Requirements, and Automation for Talos Director - #860

Draft
sterlingkoch wants to merge 1 commit into
mainfrom
director/overview-pages
Draft

sterlingkoch wants to merge 1 commit into
mainfrom
director/overview-pages

Conversation

@sterlingkoch

Copy link
Copy Markdown
Member

Draft until #858 and #859 merge. This page set links to both, so the broken-link check fails until then. I'll rebase onto main once they're in; the nav and docs.json will need a regenerate at that point.

What

Three new pages under Overview: Coming from VMware, Requirements and Supported Platforms, and Automation. Also adds them, How Talos Director Works, and What Happens During a Migration to the "where to go next" list on What Is Talos Director?

Why

Most Director evaluators are moving off vSphere. They want to know what our names are for the things they already use, what hardware and storage are validated, and what they can automate. None of that has a page today.

Change

  • coming-from-vmware.mdx: a table of about 20 vSphere terms mapped to Talos Director (vCenter, ESXi, DRS, HA, vMotion, EVC, datastores, port groups, NSX DFW, content libraries, VKS, and so on), what works differently, and where to start a migration.
  • requirements.mdx: servers, storage, networking, guests, Kubernetes, and migration sources, each marked Validated, Supported, or Roadmap, plus host and migration requirements.
  • automation.mdx: the REST API and its OpenAPI specification, the Equivalent CLI / API panel, Terraform after GA, and kubectl access. SDKs and other tools get added once it's confirmed which ones customers can use.
  • Nav entries in director.yaml, the regenerated docs.json, and five links on What Is Talos Director?

Testing

@sterlingkoch sterlingkoch added documentation Improvements or additions to documentation director Talos Director documentation labels Oct 8, 2026
@mintlify

mintlify Bot commented Oct 8, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
siderolabs 🟢 Ready View Preview Oct 8, 2026, 3:02 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

@github-actions

github-actions Bot commented Oct 8, 2026

Copy link
Copy Markdown

📋 Automated documentation review

⚠️ The reviewer did not finish on commit bb1d33a (it timed out or errored) — see the workflow run log. This run did not produce a result; any findings from an earlier run on this PR still stand.

@@ -0,0 +1,22 @@
---
title: Automation

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

i am not sure i can deduce what this page is about from the title automation, and this is especially important, when i am looking for a page through the navbar, or through search or maybe even using claude

@@ -0,0 +1,22 @@
---
title: Automation

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

i feel like this page, could be folded into another page, but its definitely up for discussion. i also dont want us to crowd the overview section too much. but then again up for discussion as well

@@ -0,0 +1,53 @@
---
title: Coming from VMware

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

i dont know if this page's title is so different from the Migrate from vmware title. Maybe a more descriptive title

Also we mention VMWare so much already, probably the third page dedicated to VMware, i worry its starting to lean markety


**VMware software stays VMware's.** Warm migrations use VMware's Virtual Disk Development Kit (VDDK) when it is available. Talos Director does not bundle it, so you upload it from your own VMware entitlement. See [What Happens During a Migration](/director/compute/what-happens-during-a-migration).

## Moving your VMs

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

i think the migrate from vmware page should also link to this page, what do you think?

| VMware Tools | QEMU guest agent and VirtIO drivers | Installed in the guest. The migration engine removes VMware Tools during conversion. |
| vSphere Kubernetes Service | Kubernetes clusters | Talos Linux clusters on VMs, created from the same console and managed through Omni. See [Kubernetes Clusters](/director/kubernetes/kubernetes-clusters). |

## What is different

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

also i think a more descriptive title here

This branch was successfully deployed

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

Labels

director Talos Director documentation documentation Improvements or additions to documentation

Projects

Status: In Progress

Development

Successfully merging this pull request may close these issues.

2 participants