Ask Your Question

Step-by-step guide to a small working system

asked 2016-01-06 11:24:31 -0600

jqfl gravatar image

I've read several guides and tutorials but so far I haven't found a step-by-step guide to install and configure Puppet.

Here is my situation: I want to start using Puppet OpenSource to manage my small network at home, and after reading about Puppet and trying to understand how it works, I'm still not able to build a simple working system with two computers. Each tutorial has a different package name and configuration for puppet and I still don't know which one I should use.


  • What exactly is the difference between: Puppet OpenSource and Enterprise?
  • What is Hiera?

To make a test, I have two computers with Debian 8, and they are in the same network (LAN). Can someone give me a simple step-by-step guide to do the following:

  • Install the Puppet Master in one PC
  • Install the Puppet Client (Agent) in the other PC
  • Create a manifest in the Master (containing a simple package like "vim") and apply it to the Client

I'm not asking for long, complicated guides with all the certificate stuff explained, all I want is a starting point so I can see Puppet working.

edit retag flag offensive close merge delete


What output / errors do you get when executing "puppet agent -t" on your Puppet Client? What does your puppet.conf look like on both machines? .)

Kozzio gravatar imageKozzio ( 2016-01-07 01:13:01 -0600 )edit

3 Answers

Sort by ยป oldest newest most voted

answered 2016-01-07 01:11:46 -0600

I would recommend you start with the Puppet Reference Manual -

Keep it simple in the beginning, don't try to build puppet master and connect agents from the start, use a standalone puppet installation and then grow it a centralized one, check it out here -

About Hiera - it lets you store key-value pairs which you can later use as parameters in your puppet modules. It is also hierarchical in the sense that you can define different groups or "layers" of parameters, for example parameteres that are relevant only ofr a specific type of OS, parameters that are relevant to one datacenter, etc, etc.

Hope that helps, if not come back with more questions :)

edit flag offensive delete link more

answered 2016-01-07 04:52:31 -0600

nobody gravatar image

updated 2016-01-07 14:18:39 -0600

Yo. Here is my simple man for centos 7: You may not install puppetdb, it's not necessary. After install master, make your vim-manifest:

On machine with puppet master:

  1. iptables -F; iptables -X
  2. touch /etc/puppetlabs/code/manifests/groups.pp
  3. echo "package { "vim": ensure => installed }" >> /etc/puppetlabs/code/manifests/groups.pp
  4. echo "autosign = true" >> /etc/puppetlabs/puppet/puppet.conf
  5. systemctl restart puppetserver.service

On machine with puppet client:

  1. puppet agent --no-daemonize --debug --onetime --server=YOURPUPPETMASTERSERVERHERE
edit flag offensive delete link more


For clarity, in your final puppet agent line, --server=YOURPUPPETMASTERSERVERHERE

DarylW gravatar imageDarylW ( 2016-01-07 07:07:05 -0600 )edit

DarylW, yes, thanks :)

nobody gravatar imagenobody ( 2016-01-07 14:19:20 -0600 )edit

answered 2016-01-06 20:36:58 -0600

updated 2016-01-07 05:32:39 -0600

Have you tried the Quest Learning VM? That should get you fairly quickly to a working Puppet, and along the way you'll find the answers to the other questions you have asked.

edit flag offensive delete link more


I'd definitely get started with the learning VM. Do this before anything else to understand the key concepts before going on your own. Don't build any master in the beginning. Just install the agent and play with it. You can be very effective only with the agent to understand how puppet works.

Sarsa-JP gravatar imageSarsa-JP ( 2016-01-09 20:47:28 -0600 )edit

Your Answer

Please start posting anonymously - your entry will be published after you log in or create a new account.

Add Answer

Question Tools



Asked: 2016-01-06 11:24:31 -0600

Seen: 201 times

Last updated: Jan 07 '16