Installing Puppet

Sections

To get started using Puppet, you must first complete the initial installation and setup process.

Puppet is distributed in several packages. These include puppetserver, puppet-agent and puppetdb. Puppet Server controls the configuration information for one or more managed agent nodes. PuppetDB is where the data generated by Puppet is stored.

This guide walks you through the following steps in installing Puppet:
  • Enabling the Puppet platform repository

  • Installing Puppet Server

  • Installing Puppet agent

  • Installing PuppetDB (optional)
You install each of these components separately, operating on a single node. From here, you can scale up to the large installation as your infrastructure grows, or customize configuration as needed.
Note: The puppetserver component of the Puppet platform is available only for Linux. The puppet-agent component is available independently for over 30 platforms and architectures, including Windows and macOS. For more information on Puppet's packages, see Puppet packages and versions.

1. Enable the Puppet platform repository

Enabling the Puppet platform repository makes the components needed for installation available on your system. The process for enabling the repository varies based on your package management system.

Before you begin
Identify the URL of the package you want to enable based on your operating system and version. *nix platform packages are located in a Puppet.com repository corresponding to the package management system.
Package management system URL naming convention URL example
Yum

(Used with Red Hat operating systems such as Red Hat Enterprise Linux (RHEL) and SUSE Linux Enterprise Server.)

https://yum.puppet.com/<PLATFORM_NAME>-release-<OS ABBREVIATION>-<OS VERSION>.noarch.rpm https://yum.puppet.com/puppet6-release-el-7.noarch.rpm
Apt

(Used with Debian and Ubuntu.)

https://apt.puppet.com/<PLATFORM_VERSION>-release-<VERSION CODE NAME>.deb
Tip: For Ubuntu releases, the code name is the adjective, not the animal.
https://apt.puppet.com/puppet6-release-wheezy.deb

Enable the Puppet platform on Yum

Logged in as root, run the RPM tool in upgrade mode:
sudo rpm -U <PACKAGE_URL>
Note: For Enterprise Linux 5, you must download the package before running RPM:
wget https://yum.puppet.com/puppet6-release-el-5.noarch.rpm
sudo rpm -Uvh puppet6-release-el-5.noarch.rpm
For example, to enable the Enterprise Linux 7 repository:
sudo rpm -Uvh https://yum.puppet.com/puppet6-release-el-7.noarch.rpm

Enable the Puppet platform on Apt

  1. Logged in as root, download the package and run the dpkg tool in install mode:
    wget <PACKAGE_URL>
    sudo dpkg -i <FILE_NAME>.deb
    For example, to enable the Ubuntu 18.04 Bionic repository:
    wget https://apt.puppetlabs.com/puppet6-release-bionic.deb
    sudo dpkg -i puppet6-release-bionic.deb
  2. Update the apt package lists: sudo apt-get update
Results
Certain operating systems and installation methods automatically verify package signatures. In these cases, you don’t need to do anything to verify the package signature. These methods include:
  • If you install from the Puppet Yum and Apt repositories, the release package that enables the repository also installs our release signing key. The Yum and Apt tools automatically verify the integrity of packages as you install them.

  • If you install a Windows agent using an .msi package, the Windows installer automatically verifies the signature before installing the package.

    If you need to manually verify packages, see Verify packages.

2. Install Puppet Server

Puppet Server is a required application that runs on the Java Virtual Machine (JVM) on the master.

In addition to hosting endpoints for the certificate authority service, Puppet Server also powers the catalog compiler, which compiles configuration catalogs for agent nodes, using Puppet code and various other data sources.

In this section, you will install the puppetserver package and start the service.

Follow the steps in install Puppet Server

3. Install Puppet agent

Puppet agents translates code into commands and then executes it on the systems you specify.

In this section, you will install agents on your chosen operating system, configure them, and sign their certificates. Follow the steps in install agents.

4. Install PuppetDB (optional)

All of the data generated by Puppet is stored in Puppet DB.

You can optionally install PuppetDB to enable extra features, including enhanced queries and reports about your infrastructure. In this section, you will assign PuppetDB module’s classes to your servers. Follow the steps in install PuppetDB.

How helpful was this page?

If you leave us your email, we may contact you regarding your feedback. For more information on how Puppet uses your personal information, see our privacy policy.

Puppet sites use proprietary and third-party cookies. By using our sites, you agree to our cookie policy.