Note: This document covers open source releases of Puppet version 3.8 and lower. For current versions, you should see instructions for installing the latest version of Puppet or installing Puppet Enterprise.
Before installing Puppet, review the pre-install tasks.
Puppet publishes and tests open-source Puppet 3.8 packages for Fedora 20 to yum.puppetlabs.com.
Users of out-of-production versions might have vendor packages of Puppet available, but can’t use our provided packages.
To install on other operating systems, see the product navigation.
Step 1: Enable the Puppet Package Repository
The newest versions of Puppet can be installed from the yum.puppetlabs.com package repository.
To enable the repository, run the command below that corresponds to your OS version:
$ sudo rpm -ivh https://yum.puppetlabs.com/puppetlabs-release-fedora-20.noarch.rpm
Optionally: Enable Prereleases
To test release candidate (RC) versions of Puppet and related projects, you can enable the prerelease repo, which is disabled by default. Note that RCs can contain unexpected changes, so be careful.
After installing the repos, open your
/etc/yum.repos.d/puppetlabs.repo file for editing. Locate the
[puppetlabs-devel] stanza, and change the value of the
enabled key from
[puppetlabs-devel] name=Puppet Labs Devel <%= @dist.capitalize -%> <%= @version -%> - $basearch baseurl=https://yum.puppetlabs.com/<%= @dist.downcase -%>/<%= @codename -%>/devel/$basearch gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-puppetlabs enabled=1 gpgcheck=1
To disable the prerelease repo, change the value back to
Step 2: Install Puppet on the Puppet Master Server
(Skip this step for a standalone deployment.)
On your Puppet master node, run:
sudo yum install puppet-server
This installs Puppet and a
systemd configuration (
/usr/lib/systemd/system/puppetmaster.service) to run a test-quality Puppet master server.
Do not start the Puppet master service yet.
Note: Read our tips on upgrading before upgrading your Puppet deployment.
To upgrade a Puppet master to the latest version of Puppet 3, run:
sudo puppet resource package puppet-server ensure=latest
After upgrading, restart the Puppet master web server.
Step 3: Install Puppet on Agent Nodes
On your other nodes, run
sudo yum install puppet. This will install Puppet and a systemd configuration (
/usr/lib/systemd/system/puppet.service) for running the puppet agent daemon.
(Note that prior to Puppet 3.4.0, the agent service name on Fedora ≥ 17 was
puppetagent instead of puppet. This name will continue to work until Puppet 4, but you should use the more consistent
Do not start the
puppet service yet.
Note: Be sure to read our tips on upgrading before upgrading your whole Puppet deployment.
To upgrade a Puppet agent to the latest version of Puppet 3, run:
$ sudo puppet resource package puppet ensure=latest
After upgrading, restart the
At this point, Puppet is installed, but it isn’t configured or running. You should now do the post-install tasks.