Modular reporting for Munki
Python JavaScript CSS HTML Shell Makefile Dockerfile
Permalink
Failed to load latest commit information.
.circleci Indenting Jun 23, 2018
api Machine id everywhere Aug 5, 2018
assets Images for docs, plugin data processing Nov 3, 2016
catalog Feature rework install log processing (#240) Jun 20, 2018
datatableview Autopep Feb 6, 2018
docker CORS in nginx so clients that need it don't need to have such wide op… Jul 25, 2018
inventory Remove commented out code. Aug 9, 2018
licenses Replace `ga_required` with `required_level` in LIcenses. Mar 1, 2018
plugins Moved a lot of the plugins around Jan 6, 2014
profiles fixed typo Jul 27, 2018
sal Machine id everywhere Aug 5, 2018
scripts Split out scripts and merge in Docker bits Aug 3, 2015
search Only delete the cache when we're ready to recreate it Jun 28, 2018
server Improve readability of new implementation. Aug 9, 2018
setup Update some requirements Jun 20, 2018
site_static Initial support for chrome Feb 13, 2018
static First commit Sep 10, 2013
templates Fix empty InstallReport, add report title block, restructure text_utils. Mar 12, 2018
.flake8 Merge branch 'master' into faster_deletes Apr 26, 2018
.gitignore Fixings Jun 21, 2018
3rdpartyclients.md Initial commit of 3rd party client docs Oct 17, 2017
Dockerfile Add back in the missing dependencies Feb 8, 2018
LICENSE Create LICENSE Jul 1, 2015
Makefile Kill brute force protection and add in deployed status Mar 20, 2017
Procfile Procfile for heroku May 19, 2014
README.md correcting reference to Slack channel Dec 12, 2017
docker-compose.yaml This stuff didn't work Apr 3, 2017
manage.py The start of user management. Nov 22, 2014
requirements.txt Gevent worker Apr 19, 2018
sal.wsgi Fix old code to be compatible with Django 1.8 Jul 4, 2015
set_build_no.sh Bump ze version Jul 24, 2018

README.md

Sal

Sal is a multi-tenanted reporting dashboard for Munki with the ability to display information from Facter. It has a plugin system allowing you to easily build widgets to display your custom information from Facter or Munki's conditional items (or both!).

With Sal, you are able to allow access to reports on certain sets of machines to certain people - for example, giving a manager access to the reports on the machines in their department.

Sal also features powerful search capabilities and application inventory and support for Munki's license tracking.

Sal

Getting Started

First off, you're going to need to get the Server and then the Client component of Sal installed. Instructions can be found here.

Once you've got clients reporting in, you're probably going to want to customise what you see on the various screens. Here is a full list of the various options that can be set in sal/settings.py.

If you would like a demo of setting up Sal along with some of the features please watch the following presentation Graham made at the 2014 Penn State MacAdmins Conference. Slides available from here.

Search

Sal has full search across machines, Facts and Munki conditions. For more information, see it's documentation.

Search

Plugins

You can enable, disable and re-order your plugins from the Settings page, under the 'person' menu in the main menu bar. For more information on using and installing your own plugins, visit the Using Plugins page.

After re-ordering and hiding plugins from some screens, you might even want to make your own plugins. You can base your plugin off of one of the included ones, or one of mine in the repository of optional plugins. For more information on writing plugins, check out the wiki.

External Authentication

There are variants of Sal that support both SAML and LDAP authentication.

Having problems?

You should check out the troubleshooting page, consider getting in touch via the Google group, or heading over the the #sal channel on the macadmins.org Slack.

API

There is a simple API available for Sal. Documentation can be found at docs/Api.md

Why Sal?

It's the Internet's fault! I asked on Twitter what I should call it, and Peter Bukowinski (@pmbuko) suggested the name, based on a Monkey puppet called Sal Minella.