Download Puppet Discovery for your operating system at https://puppet.com/download-puppet-discovery. This section will help us put the binary in our path and set up Puppet Discovery for the first time.

After we've downloaded Puppet Discovery, we'll want to move the binary into our path. On most Unix-based operating systems, /usr/local/bin is in your path. We need to place our binary in our path, make it executable, and ensure we can run it as the local user:

rary at Ryans-MacBook-Pro in ~/workspace
$ mv ~/Downloads/puppet-discovery /usr/local/bin

rary at Ryans-MacBook-Pro in ~/workspace
$ chmod a+x /usr/local/bin/puppet-discovery

rary at Ryans-MacBook-Pro in ~/workspace
$ puppet-discovery
A discovery application for cloud-native infrastructure

  Find more information at https://puppet.com/products/puppet-discovery

Usage:
  puppet-discovery [command]

...

Once we've verified that the binary works, we'll run puppet-discovery start to start the service. We'll be prompted to provide a license key, read the EULA (which will pop up in a browser), and generate an administrative password:

rary at Ryans-MacBook-Pro in ~
$ puppet-discovery start
Please enter the path to your Puppet Discovery license: Documents/License-puppet-discovery-trial-2018-10-23.puppet_discovery.json

By continuing with installation, you agree to terms outlined in the Puppet Discovery End User License Agreement located here: /Users/rary/.puppet-discovery/data/puppet-discovery-eula-1537730629.html

Do you agree? [y/n]: y

*************************************************************************
* NOTE: If you forget your password you lose all of your discovery data *
*************************************************************************

Password requirements:
* Password must have at least 6 characters
* Password must use at least 3 of the 4 character types: lowercase letters, uppercase letters, numbers, symbols
* Password cannot be the same as current password

Please create an admin password: **************
Verify by entering the same password again: **************

Puppet Discovery: started 15s [====================================================================] 100%
Puppet Discovery: pulled [8/8] 1m3s [====================================================================] 100%
Opening Puppet Discovery at https://localhost:8443 ...

Once we've finished this step, Puppet Discovery will be running on port 8443 on our target machine in a Docker container.