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 Sep 15, 2015 @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 Feb 21, 2014
app Rescue correct psych exception in ResourceEvent::ValueWrapper Apr 6, 2015
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 Systemd files for puppet-dashboard and workers services, plus a shell Aug 29, 2015
lib Change from MD5 to SHA256 digests Aug 10, 2015
log Add some gitkeeps. Mar 6, 2013
public Delete rails.png Feb 18, 2014
script rails generate delayed_job:upgrade Mar 6, 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 2, 2011
.gitignore Remove rbenv, add it to gitignore. Apr 6, 2013
.travis.yml Update Travis: remove SQLite, add Ruby 2.1, remove old Rubygems worka… Dec 28, 2014
CONTRIBUTING.md fix the CLA link Mar 26, 2013
CONTRIBUTORS.md Update Contributors Apr 26, 2013
Gemfile Bundle update for Rails 3.2.21, mysql2 0.3.17, eventmachine 1.0.4. Dec 28, 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 14, 2011
PLUGINS.md Added some documentation on writing plugins. Dec 19, 2011
README.markdown Switch to bundle install --deployment in the quick start guide Jun 16, 2014
Rakefile There is no tasks/rails anymore Jan 7, 2014
VERSION Bump version to 2.0.0-beta1 Jan 9, 2014
config.ru Add rackup config.ru Mar 6, 2013

README.markdown

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.

Dependencies

  • 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

Contributing

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!