Workspace ONE Assist for Linux Release Notes provides information on the features of the Workspace ONE Assist 21.11 for Linux release. 

Workspace ONE Assist is a Remote Access solution to empower your IT and Help desk staff to troubleshoot and fix device issues in real-time, directly from the Workspace ONE Console with tools like File Manager and Remote Shell. Console users can now experience the same consistent workflow available on other platforms like Android, Windows 10, and macOS, now on Linux. 

To provision a Linux device with Assist, install the Workspace One Assist agent on a Workspace ONE managed Linux device.

New Features

Workspace ONE Assist 21.11 for Linux

The following functionalities are available in the 21.11 release:

  • Ability to manage the file system on the remote device using the File Manager Tool.
  • Ability to run commands on the remote device using the Remote Shell Tool.
  • Role-based access controls to File manager and Remote shell functionality.


  • Linux support in Workspace ONE Unified Endpoint Management (UEM) available only for SaaS customers currently will be deployed to SaaS environments in phases.
  • Assist is currently only available on SystemD Linux devices and SystemV devices are not yet supported.
  • For more information on Linux device management, please refer to the product announcement,
  • Please refer to the knowledge base article for more details,

Minimum Requirements

  • Workspace ONE Assist Console - 21.09
  • Linux  x64, ARM5, or ARM7 architecture
  • Linux installer files of deb, rpm, and tgz are available
  • Workspace ONE UEM 2109
  • Latest versions of Chrome, Edge, Firefox, or Safari
  • Workspace ONE Intelligent Hub 1.0 for Linux

The following client packages are available in various flavors of Linux.

  • linux-x64 (Most desktop distributions like CentOS, Debian, Fedora, Ubuntu, and derivatives)
  • linux-arm (Linux distributions running on ARM like Raspbian on Raspberry Pi Model 2+)
  • linux-arm64 (Linux distributions running on 64-bit ARM like Ubuntu Server 64-bit on Raspberry Pi Model 3+)

Current Limitations

Assist sessions on Linux devices will support Unattended access only in this release. The ability to view and control a device screen will be introduced in upcoming releases.

Assist is currently only available on SystemD Linux devices, and SystemV devices are not yet supported.

Download Instructions

To remotely manage a Linux or Linux-based IoT device, you must install the Workspace ONE Assist application on a Linux device already enrolled in UEM. You can install the Assist application by following one of the methods described below. Once the Assist application is installed on the Linux device, you must register it to the Workspace ONE Assist server. You can verify the registration status by navigating to the Device detailed view > More > Troubleshooting > Event Logs.

Installation Method 1:

Install the Workspace ONE Assist agent on the remote Linux device using a WS1 Custom Configuration Profile that uses Puppet manifests. 

  1. On the Workspace ONE UEM console, navigate to Profiles and Baselines-> Profiles to add a new Custom Configuration profile. Depending on the UEM version, the Profiles tab would be present either in Resources or in Devices.
  2. Create a new Linux Profile or update an existing one to add a new custom configuration for Workspace ONE Assist. 
  3. On the Custom Configuration page, enter a name and create a puppet manifest to install the Assist application on your Linux devices. We have provided a sample manifest in the readme file and with the product which you can modify and use if desired.
  4. Once you add the Custom Configuration, save and publish the Linux profile to your Linux devices. 

Installation Method 2:

If you have physical access to the Linux device, install the Assist Agent manually using this method.

On the Linux device, open a browser and navigate to the VMware Workspace ONE Resource Portal and download the Workspace ONE Assist agent directly on the Linux device. Alternative methods of copying the agent to the Linux device would also work. 

Extract and install the package in the Linux device to install Assist.

Support Contact Information

To receive support, either submit a ticket with the My Workspace ONE portal or call your local support line.

check-circle-line exclamation-circle-line close-line
Scroll to top icon