Skip to content
Server automation framework and application
Ruby Puppet Shell Emacs Lisp VimL Python
Find file
Pull request Compare This branch is 9509 commits behind puppetlabs:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
acceptance (#19558) Fix acceptance test failure
autotest (maint) Ensure every file has a trailing newlines
bin (maint) Add Travis CI Support
conf (#7911) Moved libuser.conf to lib/puppet/util/libuser.conf
examples Maint: Remove sample_module example
ext Merge branch '3.1.x'
lib (#19663) Remove --include-dependencies flag in gem package provider
man Maint: Update man pages
spec (#19663) Remove --include-dependencies flag in gem package provider
tasks Remove gem.rake from 3.0.x
yardoc/templates/default (#18023) Document user facing classes using yardoc and show api.
.gitignore (main) Add puppet-acceptance/ to .gitignore
.mailmap (maint) Update mailmap for git shortlog
.noexec.yaml (#15464) Exclude gem command from bundler
.testseries Updated test series
.travis.yml (#18494) Enable Travis building on Ruby 2.0.0
.yardopts (Maint) Use --api instead of generic --query in yardopts
COMMITTERS.md (docs) Add COMMITTERS.md to guide committers
CONTRIBUTING.md Mark git diff --check as inline code
Gemfile Merge branch '3.1.x'
LICENSE Update copyright years in LICENSE
README.md (Maint) Point users to mailing list and IRC
README_DEVELOPER.md Merge branch 'pull-1506'
Rakefile Merge remote-tracking branch 'upstream/2.7.x' into 3.0.x
install.rb (#7911) Moved libuser.conf to lib/puppet/util/libuser.conf
puppet.gemspec (maint) Add Travis CI support to active branches

README.md

Puppet

Build Status

Puppet, an automated administrative engine for your Linux, Unix, and Windows systems, performs administrative tasks (such as adding users, installing packages, and updating server configurations) based on a centralized specification.

Documentation (and detailed installation instructions) can be found online at the Puppet Docs site.

Installation

Generally, you need the following things installed:

  • A supported Ruby version. Ruby 1.8.7, and 1.9.3 are fully supported.

  • The Ruby OpenSSL library. For some reason, this often isn't included in the main ruby distributions. You can test for it by running ruby -ropenssl -e "puts :yep". If that errors out, you're missing the library.

    If your distribution doesn't come with the necessary library (e.g., on Debian and Ubuntu you need to install libopenssl-ruby), then you'll probably have to compile Ruby yourself, since it's part of the standard library and not available separately. You could probably just compile and install that one library, though.

  • Facter => 1.6.11 (available via your package manager or from the Facter site).

Contributions

Please see our Contibution Documents and our Developer Documentation.

License

See LICENSE file.

Support

Please log tickets and issues at our Projects site. A mailing list is available for asking questions and getting help from others. In addition there is an active #puppet channel on Freenode.

Something went wrong with that request. Please try again.