System requirements

Before installing Puppet Discovery, ensure your system meets these requirements.

Supported operating systems

Puppet Discovery can be installed on these operating systems:


Operating System	Versions	Architecture	Prerequisite
CentOS	7 or higher	x64	Docker CE 17.04.0-ce or higher, or Docker EE 17.06.1-ee or higher.
Red Hat Enterprise Linux	7 or higher	x64	Docker EE 17.06.1-ee or higher.
Debian	8 or higher	x64	Docker CE 17.04.0-ce or higher.
Ubuntu	14.04 or higher	x64	Docker CE 17.04.0-ce or higher, or Docker EE 17.06.1-ee or higher.
macOS	10.10 or higher	x64	Docker for macOS.
Windows	10	x64	Docker for Windows.

Important: Docker requirements:

Both Docker CE and Docker EE editions include the option to run Kubernetes as a single-node cluster using port 8080 on a local machine. Puppet Discovery requires that no other application is using ports 8080 and 8443.
To configure log rotation and to prevent running out of space, edit the log-driver and log-opts parameters within the daemon configuration file located here:
- macOS or Linux: /etc/docker/daemon.json
- Windows: %programdata%\docker\config\daemon.json

Discover data on these operating systems:


Operating system	Versions	Prerequisite
Enterprise Linux: CentOS Red Hat Enterprise Linux	5 or higher	For the account Puppet Discovery authenticates with, configure bash as the login shell.
Debian	7 or higher	For the account Puppet Discovery authenticates with, configure bash as the login shell.
SUSE Linux Enterprise Server	12	For the account Puppet Discovery authenticates with, configure bash as the login shell.
Ubuntu	14.04 or higher	For the account Puppet Discovery authenticates with, configure bash as the login shell.
Windows Server	2012 or higher	Configure WinRM to enable PowerShell remoting.

Before installing Puppet Discovery, make sure that your network is properly configured. These are the port requirements for a Discovery installation.

Port	Description
`443` (HTTPS)	Required to install or update to the latest version of Puppet Discovery from: storage.googleapis.com gcr.io
`8443` (HTTPS) `8080` (HTTP)	Required to view the Puppet Discovery dashboard.
`22`	Required for SSH authentication on discovered Linux/macOS hosts.
`5986` (HTTP) `5985` (HTTP - fallback)	Required for WinRM authentication on discovered Windows hosts.

Important: The ICMP protocol is required for discovering hosts using the network based (IP) discovery. See IP addresses.

Puppet Discovery requires:

The Puppet Discovery user interface is supported on the latest versions of the following browsers: