This getting started guide uses a web-based installer to walk you through a basic monolithic Puppet Enterprise (PE) installation, ideal for trying out PE with up to 10 nodes, or for managing up to 4000 nodes.
Here we use a web-based installer to walk you through a basic monolithic Puppet Enterprise installation, ideal for trying out PE with up to 10 nodes. On a single *nix machine, you'll install:
- The Puppet master, the central hub of activity, where Puppet code is compiled to create agent catalogs, and where SSL certificates are verified and signed.
- The console, PE's web interface, which features numerous configuration and reporting tools.
- PuppetDB, which collects data generated throughout your Puppet infrastructure.
Step 1: Review installation prerequisites on your Linux server
Before getting started, review this checklist to make sure you're ready to install PE.
Be aware that you'll need to work as the
rootuser on the command line throughout the installation process.
Make sure you meet the hardware recommendations for 10 or fewer
You can download and install Puppet Enterprise on up to 10 nodes at no charge.
Make sure that DNS is properly configured on the
server you're installing on.
All nodes must know their own hostnames, which you can achieve by properly configuring reverse DNS on your local DNS server, or by setting the hostname explicitly. Setting the hostname usually involves the
hostnamecommand and one or more configuration files, but the exact method varies by platform.
All nodes must be able to reach each other by name, which you can achieve with a local DNS server.
Know the fully qualified domain name (FQDN) of the
server you're installing PE
on, for example,
- The web-based installer requires access to port 3000 on the server you're running the installer from.
Step 2: Prepare your Windows System
Some extra software is necessary so that you can communicate and work between your Windows and Linux machines.
On your Windows machine:
- Set up an SFTP client. Popular clients include FileZilla and WinSCP. The examples below use WinSCP.
- Set up an SSH Client. The examples below use the Putty SSH client.
Step 3: Install the master on your Linux machine
These steps show you how to use a Windows machine to install a Puppet master on a Linux server.
Open the SSH client, and enter the IP address and
port of the Linux machine
that you want to use as your master. You can then open an SSH session to the
When prompted in the terminal, log into the Linux node as the
Download the PE installer to the server that will be your
master by copying the appropriate download URL from the downloads page and running:
wget --content-disposition '<DOWNLOAD_URL>'
The web-based installer requires access to port
3000 on the node you're running the installer from. If you can't connect
directly to port 3000, you can port forward — or "tunnel" — to the installer
- Open PuTTY. Select Sessions and in the Host Name field, enter the FQDN of the host you want to run the installer from.
- Select Tunnels and in the Source Port field, enter 3000.
- In the Destination field, enter localhost:3000.
- Select Local, click Add, and then click Open.
Run the following command to unpack the
tar -xf <TARBALL>Note: You need about 1 GB of space in
Change directories to the installer directory, and
run the installer:
When prompted, choose the guided installation
The installer starts a web server and provides an installer URL.
The default installer URL is
https://<INSTALL_PLATFORM_HOSTNAME>:3000. If you forwarded ports in step 1, the URL is
Copy this address into your browser (make sure to use
In a browser, access the installer URL and accept
the security request.
The installer uses a default SSL certificate. You must add a security exception in order to access the installer.Important: Leave your terminal connection open until the installation is complete or else installation fails.
On the installer page, click Let's get started.
Step 4: Personalize your installation
The installer collects key configuration information, which is used to make sure your installation is set up correctly. Follow the prompts to configure your installation:
- Choose Install on this server, which will install the Puppet master component on the Linux server.
Provide the following information about the Puppet master server:
Puppet master FQDN: The fully qualified domain name of the server you're installing PE on.
DNS aliases: A comma-separated list of DNS alt names or aliases that your agent nodes (the nodes you wish to manage with PE) can use to reach the Puppet master.
- When prompted about database support, choose the default option, Install PostgreSQL for me.
Create a password for the console administrator.
The password must be at least eight characters. The user name for the console
administrator is always
- Click Submit, and then review the information you provided. If you need to make any changes, click Go back and make whatever changes are required. Otherwise, click Continue.
Log into the PE console
On the validation page, the installer verifies various configuration elements (for example, if SSH credentials are correct, if there is enough disk space, and if the OS is the same for the various components).
- When you click Start using Puppet Enterprise, you receive a browser warning about an untrusted certificate. This is because you were the signing authority for the console's certificate, and your Puppet Enterprise deployment is not known to your browser as a valid signing authority. Ignore the warning and accept the certificate.
On the login page for the console, log in with the
adminand the password you created when installing the Puppet master.