Skip to content
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
Latest commit 35d4014 @sodabrew Merge pull request #318 from ssgelm/fix-value-wrapper-crash
Rescue correct psych exception in  ResourceEvent::ValueWrapper
Failed to load latest commit information.
acceptance/tests Remove selenium acceptance tests
app Rescue correct psych exception in ResourceEvent::ValueWrapper
bin (#8146) Change default DASHBOARD_URL in external_node to localhost
config Use psych now
db Add basic environment support
ext Systemd files for puppet-dashboard and workers services, plus a shell
lib Change from MD5 to SHA256 digests
log Add some gitkeeps.
public Delete rails.png
script rails generate delayed_job:upgrade
spec Rescue correct psych exception in ResourceEvent::ValueWrapper
spool (#7938) Delayed import from file, not YAML string.
tmp (#8745) Update gitignore to not exlucde tmp during tarball creation
.gitignore Remove rbenv, add it to gitignore.
.travis.yml Update Travis: remove SQLite, add Ruby 2.1, remove old Rubygems worka… fix the CLA link Update Contributors
Gemfile Bundle update for Rails 3.2.21, mysql2 0.3.17, eventmachine 1.0.4.
Gemfile.lock Bundle update for Rails 3.2.21, mysql2 0.3.17, eventmachine 1.0.4.
LICENSE (#7568) Relicense to Apache-2.0 License Added some documentation on writing plugins.
README.markdown Switch to bundle install --deployment in the quick start guide
Rakefile There is no tasks/rails anymore
VERSION Bump version to 2.0.0-beta1 Add rackup


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 Manual.


  • 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!

Something went wrong with that request. Please try again.