Install macOS agents from Finder
You can use Finder to install agents on macOS nodes.
- Download the appropriate agent tarball.
- Open the agent package
.dmg
and click the installer.pkg
. - Follow installer dialog prompts. You must provide the primary server's hostname
and the agent's certname.
For macOS agents, the
certname
is derived from the machine's name. For best compatibility, make sure the node's name doesn't include capital letters (for example,My-Example-Mac
must bemy-example-mac
). If you don’t want to change the computer’s name, enter the agentcertname
in all lowercase letters when prompted by the installer. - Run
puppet agent -t
to add the node to the node inventory and generate the CSR. - Accept the CSR as explained in Managing certificate signing requests.