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 the following versions of Debian to apt.puppetlabs.com:
Puppet publishes and tests packages for the following versions of Ubuntu to apt.puppetlabs.com:
Ubuntu 10.04 LTS reached its end-of-life in April 2015.
Puppet Enterprise support: PE 3.8 supports these operating systems, but supports masters only on 64-bit editions of Ubuntu. Newer versions of Puppet Enterprise support more agents on more recent versions of Debian and Ubuntu, and masters on more recent versions of Ubuntu.
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.
The newest versions of Puppet can be installed from the apt.puppetlabs.com package repository.
To enable the repository:
puppetlabs-release-<CODE NAME>.deb
. (For Ubuntu releases, the code name is the adjective, not the animal.)dpkg -i <PACKAGE NAME>
.apt-get update
to get the new list of available packages.For example, to enable the repository for Ubuntu 12.04 Precise Pangolin:
wget https://apt.puppetlabs.com/puppetlabs-release-precise.deb
sudo dpkg -i puppetlabs-release-precise.deb
sudo apt-get update
To enable the repository for Ubuntu 14.04 Trusty Tahr:
wget https://apt.puppetlabs.com/puppetlabs-release-trusty.deb
sudo dpkg -i puppetlabs-release-trusty.deb
sudo apt-get update
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/apt/sources.list.d/puppetlabs.list
file for editing. Locate and uncomment the line that begins with deb
and ends with devel
:
# Puppetlabs devel (uncomment to activate)
deb https://apt.puppetlabs.com precise devel
# deb-src https://apt.puppetlabs.com precise devel
To disable the prerelease repo, re-comment the line.
(Skip this step for a standalone deployment.)
On your Puppet master, run:
sudo apt-get install puppetserver
This installs Puppet, its prerequisites, and Puppet Server, a JVM-based Puppet master server that’s ready for production.
Note: Puppet 3.8 is compatible with Puppet Server 1.1. Puppet Server 2 and newer require Puppet 4.
Do not start Puppet Server 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 apt-get update
sudo puppet resource package puppetmaster ensure=latest
After upgrading, restart Puppet Server.
On your Puppet agents, run:
sudo apt-get install puppet
This installs Puppet and an init script (/etc/init.d/puppet
) that runs the Puppet agent daemon.
Do not start the puppet
service yet.
Note: Read our tips on upgrading before upgrading your Puppet deployment.
To upgrade a Puppet agent to the latest version of Puppet 3, run:
sudo apt-get update
sudo puppet resource package puppet ensure=latest
After upgrading, restart the puppet
service.
At this point, Puppet is installed, but it isn’t configured or running. You should now do the post-install tasks.