The Puppet Dashboard is a web interface providing node classification and reporting features for Puppet, an open source system configuration management tool
JavaScript Ruby HTML CSS Shell Makefile
Clone or download
adamchainz and sodabrew README - remove recursive link (#344) redirects back to the GitHub repo so when reading there one ends up in a loop. It seems the full docs are no longer available.
Latest commit b02304a Apr 21, 2018
Failed to load latest commit information.
acceptance/tests Remove selenium acceptance tests Feb 22, 2014
app Fix "Kind can't be blank" with Puppet 5 and report format 7 (#347) Apr 18, 2018
bin (#8146) Change default DASHBOARD_URL in external_node to localhost Jun 29, 2011
config Use psych now Jan 8, 2014
db Add basic environment support Dec 17, 2014
ext Make debian init script respect DASHBOARD_ENVIRONMENT (#338) Jan 13, 2017
lib Avoid "The total number of locks exceeds the lock table size" error (#… Jan 13, 2017
log Add some gitkeeps. Mar 7, 2013
public Delete rails.png Feb 19, 2014
script rails generate delayed_job:upgrade Mar 7, 2013
spec Rescue correct psych exception in ResourceEvent::ValueWrapper Apr 7, 2015
spool (#7938) Delayed import from file, not YAML string. Jun 17, 2011
tmp (#8745) Update gitignore to not exlucde tmp during tarball creation Aug 3, 2011
.gitignore Remove rbenv, add it to gitignore. Apr 7, 2013
.travis.yml Update Travis: remove SQLite, add Ruby 2.1, remove old Rubygems worka… Dec 29, 2014 fix the CLA link Mar 25, 2013 Update Contributors Apr 26, 2013
Gemfile Bundle update for Rails 3.2.21, mysql2 0.3.17, eventmachine 1.0.4. Dec 29, 2014
Gemfile.lock Bundle update for Rails 3.2.21, mysql2 0.3.17, eventmachine 1.0.4. Dec 29, 2014
LICENSE (#7568) Relicense to Apache-2.0 License Jul 15, 2011 Added some documentation on writing plugins. Dec 20, 2011
README.markdown README - remove recursive link (#344) Apr 21, 2018
Rakefile There is no tasks/rails anymore Jan 8, 2014
VERSION Bump version to 2.0.0-beta1 Jan 9, 2014 Add rackup Mar 7, 2013


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.


  • Ruby 1.8.7, 1.9.3 or 2.0.0
  • Bundler >= 1.1
  • MySQL >= 5.1 or PostgreSQL >= 9.0

Fast Install

  • Check out the code or download a release package.
  • Create a MySQL database and user, and set max_allowed_packet to 32M.
  • Edit your config/settings.yml and config/database.yml files.
  • gem install bundler
  • bundle install --deployment
  • Generate a new secret_token in config/settings.yml: echo "secret_token: '$(bundle exec rake secret)'" >> config/settings.yml
  • bundle exec rake db:setup
  • bundle exec rails server
  • Set up Puppet to be Dashboard-aware.
  • Start the delayed job worker processes.

Production Environment

Dashboard is currently configured to serve static assets when RAILS_ENV=production. In high-traffic environments, you may wish to farm this out to Apache or nginx. Additionally, you must explicitly precompile assets for production using:

  • RAILS_ENV=production bundle exec rake assets:precompile


To contribute to this project, please read CONTRIBUTING.
A list of contributors is found in CONTRIBUTORS. Thanks!
This project uses the Silk icons by Mark James. Thank you!