n8felton / munkireport-php

A reporting tool for munki

MunkiReport

master: wip:

MunkiReport is a reporting client for macOS. While originally dependent on Munki, MunkiReport is now able to run stand-alone or to be coupled with Munki, Jamf or other macOS management solutions.

Features

• Quick overview of your macOS fleet with a customizable dashboards
• Get reports on many features (hardware types, disk usage, etc)
• Extendable with a growing list of modules
• Lightweight: only sends reports when facts have changed
• Responsive webdesign
• more features

Setup

Setup is easy, you could be running your own reporting server within minutes!

Please read the demonstration setup.

System Requirements

Serverside:

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

Clientside

• a Modern webbrowser

Mailing lists

For questions about using MunkiReport or setting up MunkiReport, you can use:

https://groups.google.com/group/munkireport

For developers who want to contribute to the project:

https://groups.google.com/group/munkireport-dev

For security related issues, please use the private mailinglist:

https://groups.google.com/group/munkireport-security

Contributing

If you want to contribute to MunkiReport, please

• read about Localizing in the docs folder
• check the modules overview for info about installing and creating modules
• fork the wip branch of repository
• create a feature branch
• send a pull request with your changes

External projects

MunkiReport makes use of these fine software packages:

• php serverside scripting
• CFPropertyList serverside plist parsing
• phpass 0.3.5 for encrypting passwords
• phpserialize for serializing client data
• jQuery for easy javascript
• Datatables table display
• nvd3 for graphs
• Moment.js for displaying time
• Bootstrap 3.0 the main webframework
• Font Awesome for icons
• adLDAP for authenticating against AD
• i18next js library for localization
• libgsx libgsx library used for GSX integration