Skip to content
Janne Lehikoinen edited this page Nov 10, 2015 · 48 revisions

Features

  • Quick overview of your mac fleet with a dashboard
  • Get reports on many features (hardware types, disk usage, etc)
  • Lightweight: only sends reports when facts have changed
  • Modular: add your own reporting items without hacking the core
  • Datatables serverside processing: short loading times for tables, no large memory allocations on the client
  • Looks great on high resolution displays
  • Responsive webdesign (adapts to screen size)

Setup

System Requirements

Apart from munki clients doing reporting, Munkireport relies on:

Serverside

  • A webserver (runs fine with Apache, IIS and nginx)
  • php version 5 with pdo-sqlite3 and libxml

Clientside (admin)

  • Modern web browser
  • For persistent storage (sorting and search in datatables) you need a browser that supports localStorage

Clientside (end-user)

MunkiReport 2.X supports Mac OS X 10.6 – 10.11.x

Upgrading

If you're coming from an older version of Munkireport, here's some instructions on how to do a safe upgrade: How-to-upgrade

Customize the interface

Sometimes you want to change some things about Munkireport so that it better represents your environment. But you don't want to apply that change every time there is an upgrade. For this you can add some customisation settings to config.php:

  • $conf['dashboard_layout'] allows for a different layout of the dashboard; add or delete widgets that appear on the dashboard
  • $conf['custom_css'] allows you to add a relative path to a custom css file to override the default css.
  • $conf['custom_js'] allows you to add a relative path to a custom js file to override the default css.
  • $conf['view_path'] allows you to change the directory that MR uses to search for the view files, you need to have all view files available in the new location. NOTE: If there's an upgrade that affects the view files, you need to take care of that yourself.

There's also a (deprecated) way to use a different dashboard: add app/views/dashboard/custom_dashboard.php to your Munkireport installation and it will show custom_dashboard.php instead of the default dashboard.

Extend Munkireport

One of the goals of this version of munkireport is to make it easier to extend the base install with your own data/widgets. Although there is still a lot of work to be done to make munkireport truly customizable, some things are in place to modify things.

Screenshots

Dashboard view

Dashboard view

Reports view

Reports view

Munki list view

Reports view

Warranty list view

Reports view

Clone this wiki locally