Skip to content

Release Notes

This page documents the key features, enhancements, and capabilities available in Holodeck releases.


Holodeck 9.0.2 – Maintenance Release

Release Date: February 2026
Supported VCF Versions: VCF 9.0.2.0, VCF 9.0.1.0, VCF 9.0.0.0, VCF 5.2.2, VCF 5.2.1, VCF 5.2
Minimum ESX Version: 8.0 U3
Release Blog: Announcing the General Availability of Holodeck 9.0.2.0

What's New

Enhancements

  • Added support for VCF 9.0.2.0 deployment
  • VCF Installer version 9.0.2.0 can be used to deploy VCF 9.0.0.0, 9.0.1.0 and 9.0.2.0 environments.
  • Introduced support for Supervisor deployment in the management domain via the new -DeploySupervisorMgmtDomain parameter. The previous -DeploySupervisor parameter has been renamed to -DeploySupervisorWkldDomain.
  • Added support for VCF Automation All Apps Org creation as a Day 2 operation.
  • New VCF Automation host protection logic added to protect the VCF Automation VM by ensuring no other VM runs on the same nested ESX host in the management domain.
  • Added route redistribution for Transit Gateway in Management NSX Edge Cluster for VCF 9.0 by default.
  • Introduced dedicated error logging to a separate error file under /holodeck-runtime/logs/, capturing detailed error diagnostics including stack traces, exception types, and full error records for easier troubleshooting.
  • Automated HTTPS certificate trust establishment between the VCF Installer and the offline depot, including automated self-signed certificate import, for automated secure depot workflows.
  • Added a precheck to ensure the IP provided for the offline depot is present in the depot certificate SAN to avoid trust establishment failures.
  • Refactored depot setup code and added support for offline depot setup in provision-only mode.
  • Automated bundle download retry on download failure in VCF Installer.
  • Automated NSX Edge Cluster certificate expiry bug workaround from KB to prevent deployment failures for VCF 9.0.0.0 and 9.0.1.0.
  • Added MasterCIDR validation to ensure only /20 CIDR blocks are used.
  • Added guardrail for proxy protocol input — only uppercase (HTTP/HTTPS) is accepted to prevent VCF Installer API failures.
  • Listed clusters and datastores alphabetically in pre-checks for easier selection.
  • Added error handling for vCenter selected as target with no clusters created.
  • Updated additional cluster deployments to use VDS MTU set to 8000.
  • Added allowLegacyCPU=true persistently to both boot.cfg and altbootbank/boot.cfg for nested ESX hosts for supporting Legacy CPU use case.
  • Removed default color-based instance naming; InstanceID is now a mandatory parameter in New-HoloDeckInstance.
  • Bookmarks and Passwords for nested VCF components added to Mozilla Firefox in webtop
  • Split DNSMASQ into 3 DNS pods and 1 DHCP pod with CNI networking for improved DNS reliability and scalability on HoloRouter.
  • Added AAAA query filtering for single site deployments to prevent DNS resolution timeouts.
  • Enhanced service definitions for Webtop and DNSMASQ on HoloRouter.
  • Fixed MTU on eth0 to 8000 on HoloRouter to resolve networking issues.
  • Updated IP and hostname mappings
Cmdlet Enhancements
  • Multi-Version Support: Holodeck now supports VCF 5.2, 5.2.1, 5.2.2, 9.0.0.0, 9.0.1.0 and 9.0.2.0. Please note that you need to upload ESX and VCF Installer (for 9.x) and Cloud Builder Appliance (for 5.2.x) versions in their respective folders at '/holodeck-runtime/bin' in HoloRouter.
  • New-HoloDeckInstance: The -Interactive parameter has been removed. Day 2 operations are now handled by the new Update-HoloDeckInstance cmdlet. InstanceID is now a mandatory parameter. The -DeploySupervisor parameter has been renamed to -DeploySupervisorWkldDomain and a new -DeploySupervisorMgmtDomain parameter has been added for deploying Supervisor in the management domain.
  • Get-HoloDeckInstance: Get details of the nested components deployed via New-HoloDeckInstance command
  • Update-HoloDeckInstance: New cmdlet for performing Day 2 operations on Holodeck, replacing New-HoloDeckInstance -Interactive. Uses -Site, -VIDomain, and operation-specific flags (-AdditionalCluster or -AddVcfAutomationAllAppsOrg). This release supports deploying an All Apps Org in VCF Automation and deploying additional clusters in the VCF instance.
  • Start-HoloDeckInstance / Stop-HoloDeckInstance: Updated to handle complex deployment types. Stop-HoloDeckInstance now implements proper power-off operations that gracefully shut down all nested VMs and VCF components in the correct order.
  • Get-HolodeckServiceIPPools: New cmdlet that displays IP pool allocations used by all Holodeck services for easier network troubleshooting.

Bug Fixes

  • Applied NSX Image validation workaround for deploying VCF 9.0.0.0 and VCF 9.0.1.0 using the 9.0.1.0 VCF Installer.
  • Fixed offline depot authentication bug to properly support authenticated depot access.
  • Fixed proxy protocol input in lowercase causing VCF Installer API failures — added guardrail to accept uppercase input only.
  • Fixed typecasting bug in pre-check input for cluster and datastore selection when the list contains more than 10 values.
  • Fixed developer mode bug for cluster and datacenter selection.
  • Fixed state management issues for Day 2 operations.
  • Fixed empty depot credentials being passed for HTTP depot configurations.
  • Fixed Set-HoloRouter -DualSite issue caused by removal of hostname proxy from Site B lab standards.
  • Fixed DNSMASQ service definition label causing service startup issues.
  • Fixed additional cluster deployment workflow and site version selection.
  • Fixed occasional issue where nested host NIC would get the wrong type assigned.
  • Updated VCF Installer DNS and NTP entries to avoid warnings during deployment pre-checks.

Known Issues

Common Known Issues

  • Hosts with memory tiering enabled may cause instability in nested workloads
  • vSAN ESA may consume more storage than expected due to nested deduplication/compression behavior
VVF 9.0.0.0 deployment fails when using VCF Installer 9.0.2.0 with 9.0.2 manifest files

Deploying VVF 9.0.0.0 using the VCF Installer 9.0.2.0 fails at the "Generate Workload Domain Runtime Data Model" step in VCF Installer UI with the error:

Failed to generate add workload domain internal model specification
Remediation: Please verify the commonsvcs and domainmanager services are running and retry

This occurs due to a bug in VCF Installer 9.0.2.0 when using 9.0.2.0 manifest. VCF Installer expects vCenter 9.0.2.0 binary even though VVF 9.0.0.0 is being deployed. The installer reports Got 0 install image(s) for product VCENTER and fails to generate the workload domain model.

Workaround

Download the vCenter 9.0.2.0 bundle as well and resume the deployment.

VCF Automation All Apps Org IP Space uses hard-coded CIDR instead of custom CIDR

When deploying the All Apps Org in VCF Automation via the Update-HoloDeckInstance command with a custom MasterCIDR (e.g., 10.2.0.0/20), the IP Spaces created in VCF Automation still use a /28 subnet from the default 10.1.0.0/20 block instead of the custom CIDR. This is because the IP Space CIDR is hard-coded in the config file. Deployments using the default MasterCIDR (10.1.0.0/20) are not affected.

Workaround

  1. With PowerShell open and the config loaded in the session, edit the config file:

    vi $config.ConfigPath
    
  2. Locate the following key and update the CIDR value to match your custom subnet (e.g., 10.2.0.32/28):

    "holodeck-sddc"."Site-A"."vcf-installer-management-domain"."vcfAutomationSpec"."allAppsOrgSpec"."networkingSpec"."ipSpaceCidr"
    
  3. Save and close the file, then reload the config:

    Import-HoloDeckConfig -ConfigID <id>
    
  4. Run Update-HoloDeckInstance — it will use the corrected CIDR range for the IP Space.

DNS resolution fails during VCF deployment — hosts unreachable by hostname

During VCF deployment, the VCF Installer may fail to resolve nested ESX host FQDNs (e.g., esx-01a.site-a.vcf.lab), causing deployment failures. Hosts are reachable by IP address but nslookup returns "connection refused".

One of the reasons this could occur is when an FQDN (e.g., cloudflare-dns.com) is provided as the upstream DNS server instead of an IP address during HoloRouter setup.

Workaround

Provide an IP address (not an FQDN) as the upstream DNS server when setting up the HoloRouter.

Track this issue here: Community Discussion

VCF 5.2.x deployments fail at Sync-HolodeckComponents with 'No route to host' error

All VCF 5.2.x deployments complete the VCF deployment successfully, but the Holodeck script fails at the final Sync-HolodeckComponents step with an error such as [ERROR] No route to host (opslcm-a.site-a.vcf.lab:443). This happens because Sync-HolodeckComponents attempts to query VCF Operations, which is not deployed in VCF 5.2.x environments.

Workaround

This error can be safely ignored — the VCF 5.2.x environment is fully deployed and functional.


Holodeck 9.0.1 – Maintenance Release

Release Date: October 2025
Supported VCF Versions: VCF 9.0.1.0, VCF 9.0.0.0, VCF 5.2.2, VCF 5.2.1, VCF 5.2
Minimum ESX Version: 8.0 U3
Release Blog: Announcing the General Availability of Holodeck 9.0.1.0

What's New

Enhancements

  • Added support for VCF 9.0.1.0, including bypassing vSAN ESA check in VCF Installer and SDDC Manager.
  • Added the capability to use custom VLAN ranges for Holodeck.
  • Added the capability to use custom DNS domain for Holodeck.
  • Enabled vCLS Retreat Mode for 9.0 clusters by default.
  • Reduced the boot time for HoloRouter VM; bumped resources to 4 vCPUs and 8 GB memory.
  • Enhanced support for special characters in target host credentials.
  • Improved cluster selection logic for vCenter targets with multiple folder levels.
  • Completed coverage for developer mode.
Cmdlet Enhancements
  • Multi-Version Support: Holodeck now supports VCF 5.2, 5.2.1, 5.2.2, 9.0.0.0 and 9.0.1.0.
  • Remove-HoloDeckInstance: New optional parameter to support automated deletion. User has 15 seconds to abort.
  • New-HoloDeckConfig: Now validates the integrity of the config.json template.
  • Set-HoloDeckDNSConfig: Removed the -update parameter. Behavior is now inferred from parameters provided.

Bug Fixes

  • NSX Edge Cluster for Site B was trying to use BGP configuration from Site A. Fixed.
  • VCF Installer for Site B was trying to get deployed in an incorrect VLAN. Fixed.
  • Online depot connection check was failing due to incorrect API response expected. Fixed.
  • Fixed DNSMASQ configuration to not respond to AAAA queries that caused nslookup commands to time out.

Known Issues

Common Known Issues

  • Hosts with memory tiering enabled may cause instability in nested workloads
  • vSAN ESA may consume more storage than expected due to nested deduplication/compression behavior
VCF 9.0.x Deployment fails on step 'Validate NSX Install Image is Available'

Fixed in: Holodeck 9.0.2

Track this issue here: GitHub Issue #89

NSX Edge deployment fails due to expired OVF certificate

Fixed in: Holodeck 9.0.2

Track this issue here: GitHub Issue #86


Holodeck 9.0 – Initial Release

Release Date: June 2025
Supported VCF Versions: VCF 9.0, VCF 5.2.x
Minimum ESX Version: 8.0 U3
Release Blog: Announcing the General Availability of Holodeck 9.0

What's New

Enhancements

  • Support for both VCF 9.0 and VCF 5.2 deployments from a single toolkit
  • vSAN ESA and OSA deployment options
  • New VVF deployment mode (VMware vSphere Foundation)
  • Proxy support for online/offline depot workflows
  • Enhanced PowerShell cmdlets with modular support:
  • New-HoloDeckConfig, New-HoloDeckInstance, Start-HoloDeckInstance, Stop-HoloDeckInstance
  • Option to deploy greenfield VCF environments with provision-only mode

Known Issues

Common Known Issues

  • Hosts with memory tiering enabled may cause instability in nested workloads
  • vSAN ESA may consume more storage than expected due to nested deduplication/compression behavior

Reporting Issues

To raise issues, feature requests, or provide feedback, please visit the Holodeck GitHub repository.