Fetching contributors…
Cannot retrieve contributors at this time
87 lines (72 sloc) 2.73 KB

Puppet Dashboard

Puppet Dashboard is a web interface for Puppet. It can view and analyze Puppet reports, assign Puppet classes and parameters to nodes, and view inventory data and backed-up file contents.

For full documentation, see the Puppet Dashboard 1.2 Manual.

Browser Support

  • Chrome (current versions)
  • Firefox 3.5 and higher
  • Safari 4 and higher
  • Internet Explorer 7 and higher


  • Ruby 1.8.7
  • RubyGems
  • Rake >= 0.8.3
  • MySQL server 5.x
  • Ruby-MySQL bindings 2.7.x or 2.8.x

Fast Install

  • Check out the code.
  • Edit your config/settings.yml and config/database.yml files.
  • Create a MySQL database and user, and set max_allowed_packet to 32M.
  • rake db:migrate
  • Start the Dashboard web server.
  • Set up Puppet to be Dashboard-aware.
  • Start the delayed job worker processes.

For detailed installation, setup, and usage instructions, see the Puppet Dashboard 1.2 Manual.


Puppet Dashboard uses Mark James' fine Silk icons.

Thanks, Mark!