Webinar: Mac Software Management for MSPs: From Visibility to Governance
Register now
Getting Started
Guide

How to manually install Workbrew on a Device

Petros Amoiridis

For most deployments, Workbrew should be distributed via your MDM. See the deployment guides for MDM-specific instructions. Use this guide when you need to add a single Device manually, for example during evaluation or troubleshooting.

Prerequisites

  • A Workbrew Workspace with an active account
  • Terminal access with sudo on the target Device
  • macOS (or Linux/WSL for beta support)

Get the install script from the Console

The Workbrew Console generates an install script for your Workspace that includes its API key. You can find it in two places:

  1. Go to the Devices page and click Add Devices > Manual setup to open the Manual Setup dialog
  2. Alternatively, go to Workspace Settings and expand Workbrew Workspace API key and installation script

Copy the install script from either location and share it with the Device user if you are not running it yourself.

Run the install script on the device

Installing Workbrew takes three steps. The Manual Setup dialog lists all three. The script in Workspace Settings covers the first two, so download and run the Installer yourself afterwards.

  1. API key setup: Creates the Workbrew home directory and writes your Workspace API key to it. This is how the Device identifies itself to your Workspace on first check-in.
  2. Command Line Tools for Xcode (macOS only): Installs the Command Line Tools if they are not already present. The Manual Setup dialog gives this its own script. You can also install them beforehand using xcode-select --install or Apple's .pkg.
  3. Workbrew Installer: Download and install the latest Workbrew Installer .pkg for macOS (or .sh for Linux/WSL for beta support).

After the Installer completes, the Device will check in with the Workbrew Console within 15 minutes and appear on the Devices page.