You upgrade to VMware Workspace ONE® Access™ 23.09 directly from Workspace ONE Access 22.09.X.

For existing deployments, if you prefer a fresh installation to an upgrade, see Installing and Configuring VMware Workspace ONE Access. Remember that a new installation does not preserve your existing configurations.

Supported Upgrade Paths

To upgrade to Workspace ONE Access 23.09, the current version must be Workspace ONE Access 22.09.X.

Note: The table lists the versions that can be upgraded in Workspace ONE Access.
From Workspace ONE Access Version Upgrade to Version
22.09. or

Additionally, legacy connectors (version and earlier) are not compatible with Workspace ONE Access virtual appliance version 23.09. You must migrate your legacy connectors to 22.09.x (or an earlier, supported version of the enterprise connector) before upgrading your Workspace ONE Access virtual appliances to 23.09.

Intended Audience

This information is intended for administrators of Workspace ONE Access. The information is written for experienced Linux and Windows system administrators who are familiar with VMware technologies, particularly vCenter™, ESX™, and vSphere®, networking concepts, Active Directory servers, databases, backup and restore procedures, Simple Mail Transfer Protocol (SMTP), and NTP servers.

Product Version Number

When the upgrade is complete, the new version of Workspace ONE Access is 23.09.

Compatibility with Workspace ONE UEM

VMware Product Interoperability Matrix provides details about the compatibility of current and previous versions of VMware products and components, such as VMware Workspace ONE UEM Console.

Internet Connectivity

You can upgrade from version 22.09.X to version 23.09 using either online or offline upgrade methods.

By default, the Workspace ONE Access appliance uses the VMware web site for the upgrade procedure. This method requires the appliance to have Internet connectivity. You must also configure proxy server settings for the appliance, if applicable.

If your virtual appliance does not have Internet connectivity, you can perform the upgrade offline. For an offline upgrade, you download the upgrade package from My VMware. You can either use the updateoffline.hzn script to perform the upgrade or set up a local Web server to host the upgrade file.

Upgrade Process Options from Workspace ONE Access 22.09.X

  • For your existing deployment, if you deployed a single Workspace ONE Access appliance, upgrade it online or offline as described in Online Upgrading to Workspace ONE Access 23.09 or Upgrading Workspace ONE Access Offline to 23.09.
    Note: Expect some downtime because all services are stopped during the upgrade. Plan the timing of your upgrade accordingly.
  • For your existing deployment of 22.09.X, if you deployed multiple virtual appliances in a cluster for failover or high availability, see Upgrade a Workspace ONE Access Cluster.
  • To upgrade from Workspace ONE Access with minimal downtime in a multi-data center deployment scenario, see "Upgrading Workspace ONE Access with Minimal Downtime" in Installing and Configuring VMware Workspace ONE Access.