From c597b13f738d535558d1cc493eeb7b272b2cfadd Mon Sep 17 00:00:00 2001 From: Ludovic Vielle Date: Wed, 29 Jul 2026 17:21:10 +0200 Subject: [PATCH] Simplify macOS agent installer enrollment copy PKG users enroll in the browser at /enroll (or via the menu bar icon), not through CLI install steps. Shorten welcome and conclusion panes and drop path inventories, MDM notes, and admin CLI setup. Signed-off-by: Ludovic Vielle --- .../installer/macos/Distribution.xml.tmpl | 2 +- .../installer/macos/Resources/conclusion.html | 59 +++++++------------ .../installer/macos/Resources/welcome.html | 57 ++---------------- 3 files changed, 28 insertions(+), 90 deletions(-) diff --git a/cmd/probo-agent/installer/macos/Distribution.xml.tmpl b/cmd/probo-agent/installer/macos/Distribution.xml.tmpl index 22a4c244c..faace9559 100644 --- a/cmd/probo-agent/installer/macos/Distribution.xml.tmpl +++ b/cmd/probo-agent/installer/macos/Distribution.xml.tmpl @@ -51,7 +51,7 @@ + description="Installs the Probo agent and menu bar helper. Enroll after install at your Probo /enroll page."> diff --git a/cmd/probo-agent/installer/macos/Resources/conclusion.html b/cmd/probo-agent/installer/macos/Resources/conclusion.html index d6a9cc03c..f1fb646a1 100644 --- a/cmd/probo-agent/installer/macos/Resources/conclusion.html +++ b/cmd/probo-agent/installer/macos/Resources/conclusion.html @@ -12,22 +12,17 @@ line-height: 1.45; } h1 { font-size: 18px; margin-bottom: 6px; } - h2 { font-size: 14px; margin-top: 18px; margin-bottom: 4px; } - code, pre { + code { font-family: Menlo, Consolas, monospace; background: #f5f5f7; border-radius: 4px; + padding: 2px 4px; } - code { padding: 2px 4px; } - pre { - padding: 8px 10px; - overflow-x: auto; - white-space: pre-wrap; - word-break: break-all; - } + ul { margin: 4px 0 8px 18px; padding: 0; } + li { margin: 2px 0; } @media (prefers-color-scheme: dark) { body { color: #f5f5f7; } - code, pre { + code { background: #3a3a3c; color: #f5f5f7; } @@ -38,36 +33,26 @@

Installation complete

- The probo-agent binary is installed. The Probo icon should - appear in the menu bar (or at your next login). To enroll, open the menu - and choose Enroll via…, then pick - United States, European Union, or - Self hosted…. Finish enrollment in your browser; when - it succeeds, the menu shows Connected and the agent - service starts automatically. + Enroll this device in your browser, or click the Probo icon in your + menu bar: +

+
    +
  • United States: + https://us.probo.com/enroll
    • +
  • European Union: + https://eu.probo.com/enroll
    • +
  • Self-hosted: + https://<your-host>/enroll
    • +
+ +

+ When enrollment succeeds, the menu bar shows + Connected and the agent starts automatically.

- If MDM already enrolled the device during installation, the menu bar - helper should already show Connected. -

- -

Administrators can also finish setup from a Terminal:

- 
sudo probo-agent install \
-    --server https://your-probo-host.example.com \
-    --enrollment-token <ENROLLMENT_TOKEN>
- -

Inspect the agent

- 
sudo probo-agent status
-sudo probo-agent collect
- -

Uninstall

- 
sudo probo-agent uninstall
- -

- Logs are written to /var/log/probo-agent.log. The - installer's own log lives at - /var/log/probo-agent-install.log. + To uninstall: sudo probo-agent uninstall
+ Logs: /var/log/probo-agent.log

diff --git a/cmd/probo-agent/installer/macos/Resources/welcome.html b/cmd/probo-agent/installer/macos/Resources/welcome.html index ae89f326f..ce24e7720 100644 --- a/cmd/probo-agent/installer/macos/Resources/welcome.html +++ b/cmd/probo-agent/installer/macos/Resources/welcome.html @@ -12,70 +12,23 @@ line-height: 1.45; } h1 { font-size: 18px; margin-bottom: 6px; } - h2 { font-size: 14px; margin-top: 18px; margin-bottom: 4px; } - code, pre { - font-family: Menlo, Consolas, monospace; - background: #f5f5f7; - border-radius: 4px; - padding: 2px 4px; - } - pre { padding: 8px 10px; overflow-x: auto; } - ul { margin: 4px 0 8px 18px; padding: 0; } - li { margin: 2px 0; } @media (prefers-color-scheme: dark) { body { color: #f5f5f7; } - code, pre { - background: #3a3a3c; - color: #f5f5f7; - } }

Welcome to the Probo Device Posture Agent

- This installer adds probo-agent, the menu bar helper, and - the probo:// enrollment app to your Mac. After enrollment, - the agent reports device posture — disk encryption, screen lock, - firewall, OS version, and similar signals — to your Probo - workspace over HTTPS. + This installer adds the Probo agent and menu bar helper to your Mac. + After you enroll, it reports device posture — disk encryption, + screen lock, firewall, OS version, and similar signals — to your + Probo workspace.

-

What the installer does

-
    -
  • Installs the probo-agent binary to - /usr/local/bin/probo-agent.
    • -
  • Installs Probo Agent.app to - /Applications so browser enrollment deep links - (probo://) work.
    • -
  • Installs the privileged helper - com.probo.agent.helper so browser enrollment can - finish without a second admin password prompt.
    • -
  • Registers the menu bar helper LaunchAgent - com.probo.agent.tray in - /Library/LaunchAgents.
    • -
  • Creates the persistent state directory - /var/lib/probo-agent (root-owned, mode 0700).
    • -
  • Enrolls the device and starts the - com.probo.agent LaunchDaemon when an admin has - pre-staged /tmp/probo-agent.conf (typically via - MDM). Otherwise, finish enrollment from the menu bar icon.
    • -
- -

What you will need

-
    -
  • Administrator privileges on this Mac.
    • -
  • The Probo server URL for your deployment (the URL of your Probo - console, e.g. https://your-probo-host.example.com). - Hosted Probo workspaces use the URL shown in your browser when you - sign in.
    • -
  • A device enrollment token issued by a workspace administrator.
    • -
-

Click Continue to review the license, then - Install to proceed. After installation, enroll from - the menu bar unless MDM already staged a configuration file. + Install.