Deploy the desktop app to managed computers

Roll out the desktop app with Intune, Jamf, Rippling, or another device management tool

IT admins can install the Circleback desktop app on their organization's computers with a device management tool like Intune, Jamf, or Rippling. Deployed this way, the app keeps itself up to date in the background without admin rights, so you don't need to push new versions.

Deploy on macOS

Install Circleback in the Applications folder inside the home folder of the person who'll use the Mac (~/Applications), not in the main Applications folder (/Applications). A copy in the main Applications folder can't update without an admin password.

Run the script below as root from your device management tool, such as a Jamf policy, an Intune shell script, or a Rippling custom script. Run it while the person who'll use the Mac is signed in. The script installs the app as that person, so they own it, and stops without changing anything if no one is signed in.

#!/bin/sh
set -e

signed_in_user=$(stat -f %Su /dev/console)
case "$signed_in_user" in
  "" | root | loginwindow | _mbsetupuser)
    echo "No one is signed in. Run this script again once someone is." >&2
    exit 1
    ;;
esac

case "$(uname -m)" in
  arm64) url="https://download.circleback.ai/mac/zip/arm64" ;;
  *) url="https://download.circleback.ai/mac/zip/x64" ;;
esac

# Runs as the signed-in user, so they own the app and its folder.
sudo -H -u "$signed_in_user" /bin/sh -s "$url" <<'INSTALL'
set -e
applications_folder="$HOME/Applications"
download=$(mktemp -d)
curl -fsSL "$1" -o "$download/Circleback.zip"
ditto -x -k "$download/Circleback.zip" "$download"
mkdir -p "$applications_folder"
rm -rf "$applications_folder/Circleback.app"
ditto "$download/Circleback.app" "$applications_folder/Circleback.app"
rm -rf "$download"
INSTALL

rm -rf /Applications/Circleback.app

The script installs the latest version and removes any copy already in either Applications folder.

To identify Circleback in configuration profiles and allowlists, use:

  • Bundle ID: com.todesktop.24062654z2002es
  • Team ID: 6CL56KHTTS

Deploy on Windows

The Windows installer sets up Circleback for the person who's signed in, in their user profile. Deploy it in the user context, not the system context, so updates don't need admin rights.

  1. Download the Windows installer.
  2. Add it to your device management tool as an app that installs in the user context. In Intune, add it as a Win32 app and set Install behavior to User.
  3. Use these commands and detection rule, with your installer's file name:
    • Install command: "Circleback Setup.exe" /S
    • Uninstall command: "%LOCALAPPDATA%\Programs\@circlebackdesktop\Uninstall Circleback.exe" /currentuser /S
    • Detection rule: the file %LOCALAPPDATA%\Programs\@circlebackdesktop\Circleback.exe exists

Allow recording permissions

The desktop app needs these permissions to record meetings. On macOS, it asks for them the first time someone records.

macOS

  • Microphone: records what each person says. Device management tools can't grant microphone access, so each person allows it when asked.
  • Screen & System Audio Recording: records other participants and the meeting video. A Privacy Preferences Policy Control (PPPC) profile can let people without admin rights allow it themselves.

Windows

  • Keep Microphone access for desktop apps turned on in Settings → Privacy & Security → Microphone.
  • Keep Screenshots and screen recording turned on in Settings → Privacy & Security → Screenshots and screen recording.

If you encounter other issues with the desktop app, check out our Troubleshooting guide.

Related articles