Webinar: Your First Homebrew Package: Simplifying Internal Software Delivery
Register to attend
Tutorial

Decommission devices

Petros Amoiridis

  1. Run the uninstall command for Workbrew on the target device: sudo /opt/workbrew/sbin/uninstall

  2. Locate the device on the Devices page in the Console and click it to enter the device details page

  3. Click on Remove Device from Workbrew Console at the bottom of the device details page. You must have write access to perform this action

  4. If the user had a Workbrew account, go to the Users tab on the Settings page and remove the user

Impact of 'Destroy Device' in Workbrew and re-enrollment process

Using Destroy Device will trigger the following actions:

  • Deletion of all command runs associated with the device

  • Removal of the device from all associated groups

  • Roll-over of the API key associated with the device

  • If the device was attached to a user or a workspace, it will need to be reattached to one or the other.

A destroyed device can be re-enrolled in a workspace, however the above actions will not be automatically undone.

Workspace vs Device API keys

To enroll devices, a Workspace API key is used. On first check-in, this key is swapped for a device-specific API key. Destroying a device invalidates the existing device-specific API key, but the Workspace API key remains unchanged.

You can reset your Workspace API key directly in the console.