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 <ludovic@probo.com>
This commit is contained in:
Ludovic Vielle
2026-07-29 17:21:10 +02:00
parent c9fa85ac52
commit c597b13f73
3 changed files with 28 additions and 90 deletions

View File

@@ -51,7 +51,7 @@
<choice id="default"/> <choice id="default"/>
<choice id="@@IDENTIFIER@@" <choice id="@@IDENTIFIER@@"
title="Probo Device Posture Agent" title="Probo Device Posture Agent"
description="Installs probo-agent, the menu bar helper LaunchAgent, and Probo Agent.app for probo:// enrollment. The LaunchDaemon starts after enrollment."> description="Installs the Probo agent and menu bar helper. Enroll after install at your Probo /enroll page.">
<pkg-ref id="@@IDENTIFIER@@"/> <pkg-ref id="@@IDENTIFIER@@"/>
</choice> </choice>
</installer-gui-script> </installer-gui-script>

View File

@@ -12,22 +12,17 @@
line-height: 1.45; line-height: 1.45;
} }
h1 { font-size: 18px; margin-bottom: 6px; } h1 { font-size: 18px; margin-bottom: 6px; }
h2 { font-size: 14px; margin-top: 18px; margin-bottom: 4px; } code {
code, pre {
font-family: Menlo, Consolas, monospace; font-family: Menlo, Consolas, monospace;
background: #f5f5f7; background: #f5f5f7;
border-radius: 4px; border-radius: 4px;
padding: 2px 4px;
} }
code { padding: 2px 4px; } ul { margin: 4px 0 8px 18px; padding: 0; }
pre { li { margin: 2px 0; }
padding: 8px 10px;
overflow-x: auto;
white-space: pre-wrap;
word-break: break-all;
}
@media (prefers-color-scheme: dark) { @media (prefers-color-scheme: dark) {
body { color: #f5f5f7; } body { color: #f5f5f7; }
code, pre { code {
background: #3a3a3c; background: #3a3a3c;
color: #f5f5f7; color: #f5f5f7;
} }
@@ -38,36 +33,26 @@
<h1>Installation complete</h1> <h1>Installation complete</h1>
<p> <p>
The <code>probo-agent</code> binary is installed. The Probo icon should Enroll this device in your browser, or click the Probo icon in your
appear in the menu bar (or at your next login). To enroll, open the menu menu bar:
and choose <strong>Enroll via…</strong>, then pick </p>
<strong>United States</strong>, <strong>European Union</strong>, or <ul>
<strong>Self hosted…</strong>. Finish enrollment in your browser; when <li>United States:
it succeeds, the menu shows <strong>Connected</strong> and the agent <code>https://us.probo.com/enroll</code></li>
service starts automatically. <li>European Union:
<code>https://eu.probo.com/enroll</code></li>
<li>Self-hosted:
<code>https://&lt;your-host&gt;/enroll</code></li>
</ul>
<p>
When enrollment succeeds, the menu bar shows
<strong>Connected</strong> and the agent starts automatically.
</p> </p>
<p> <p>
If MDM already enrolled the device during installation, the menu bar To uninstall: <code>sudo probo-agent uninstall</code><br>
helper should already show <strong>Connected</strong>. Logs: <code>/var/log/probo-agent.log</code>
</p>
<p>Administrators can also finish setup from a Terminal:</p>
<pre>sudo probo-agent install \
--server https://your-probo-host.example.com \
--enrollment-token &lt;ENROLLMENT_TOKEN&gt;</pre>
<h2>Inspect the agent</h2>
<pre>sudo probo-agent status
sudo probo-agent collect</pre>
<h2>Uninstall</h2>
<pre>sudo probo-agent uninstall</pre>
<p>
Logs are written to <code>/var/log/probo-agent.log</code>. The
installer's own log lives at
<code>/var/log/probo-agent-install.log</code>.
</p> </p>
</body> </body>
</html> </html>

View File

@@ -12,70 +12,23 @@
line-height: 1.45; line-height: 1.45;
} }
h1 { font-size: 18px; margin-bottom: 6px; } 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) { @media (prefers-color-scheme: dark) {
body { color: #f5f5f7; } body { color: #f5f5f7; }
code, pre {
background: #3a3a3c;
color: #f5f5f7;
}
} }
</style> </style>
</head> </head>
<body> <body>
<h1>Welcome to the Probo Device Posture Agent</h1> <h1>Welcome to the Probo Device Posture Agent</h1>
<p> <p>
This installer adds <code>probo-agent</code>, the menu bar helper, and This installer adds the Probo agent and menu bar helper to your Mac.
the <code>probo://</code> enrollment app to your Mac. After enrollment, After you enroll, it reports device posture &mdash; disk encryption,
the agent reports device posture &mdash; disk encryption, screen lock, screen lock, firewall, OS version, and similar signals &mdash; to your
firewall, OS version, and similar signals &mdash; to your Probo Probo workspace.
workspace over HTTPS.
</p> </p>
<h2>What the installer does</h2>
<ul>
<li>Installs the <code>probo-agent</code> binary to
<code>/usr/local/bin/probo-agent</code>.</li>
<li>Installs <code>Probo Agent.app</code> to
<code>/Applications</code> so browser enrollment deep links
(<code>probo://</code>) work.</li>
<li>Installs the privileged helper
<code>com.probo.agent.helper</code> so browser enrollment can
finish without a second admin password prompt.</li>
<li>Registers the menu bar helper LaunchAgent
<code>com.probo.agent.tray</code> in
<code>/Library/LaunchAgents</code>.</li>
<li>Creates the persistent state directory
<code>/var/lib/probo-agent</code> (root-owned, mode 0700).</li>
<li>Enrolls the device and starts the
<code>com.probo.agent</code> LaunchDaemon when an admin has
pre-staged <code>/tmp/probo-agent.conf</code> (typically via
MDM). Otherwise, finish enrollment from the menu bar icon.</li>
</ul>
<h2>What you will need</h2>
<ul>
<li>Administrator privileges on this Mac.</li>
<li>The Probo server URL for your deployment (the URL of your Probo
console, e.g. <code>https://your-probo-host.example.com</code>).
Hosted Probo workspaces use the URL shown in your browser when you
sign in.</li>
<li>A device enrollment token issued by a workspace administrator.</li>
</ul>
<p> <p>
Click <strong>Continue</strong> to review the license, then Click <strong>Continue</strong> to review the license, then
<strong>Install</strong> to proceed. After installation, enroll from <strong>Install</strong>.
the menu bar unless MDM already staged a configuration file.
</p> </p>
</body> </body>
</html> </html>