MunkiReport Setup Tweaks

05 August 2019 on macOS and MunkiReport. 2 minutes

MunkiReport Setup

I wanted to share some quick tips of things I’ve learned over the past year that help you utilize some of the lesser known config options for MunkiReport. I primarly use the Git method of installation, but some of these things will be helpful if you simply download the project as well.

Create a Separate Directory/Repo for Your Configuration Files

Arjen has done a great job of separating MunkiReport files from the configuration of these files, so my first tip is don’t store any of the config in the MunkiReport directory.

If your files live at:

/usr/local/munkireport

Create:

/usr/local/munkireport-config

Once it’s in a separate directory, it is much easier to source control.

Move your .env file to /usr/local/munkireport-config/.env and then create a symlink back to the MunkiReport root.

ln -s /usr/local/munkireport-config/.env /usr/local/munkireport/.env

Not everyone is in need of composer.local.json, but if you are installing other modules with composer, you probably should be using it. Move it to your config directory as well.

ln -s /usr/local/munkireport-config/composer.local.json /usr/local/munkireport/composer.local.json

Copy Your Local Folder and Store with Your Configuration

As of MunkiReport 4.0, the configuration has moved from config.php to .env and a local directory. The local directory contains things like certs, users, dashboards, module_configs, etc.

By default this simply lives in the MunkiReport root directory. However, we can configure this directory location by the LOCAL_DIRECTORY_PATH within our .env file. This way we do not need a symlink, but can still keep our configuration out of the root.

Copy /usr/local/munkireport/local/ to /usr/local/munkireport-config/local/ and then edit .env to contain this line:

LOCAL_DIRECTORY_PATH="/usr/local/munkireport-config/local/"

Add Custom Modules

With Composer

A lot of custom modules are available via Composer. You can add modules easily to your composer.local.json by running this command:

COMPOSER=composer.local.json composer require joncrain/manifests

(where joncrain/manifest is the name of the Packagist repository)

If you are utilizing this method, make sure that your MODULE_SEARCH_PATHS contain the full paths to the vendors folder:

MODULE_SEARCH_PATHS="/usr/local/munkireport/vendor/tuxudo/, /usr/local/munkireport/vendor/joncrain/"

Without Composer

If you are downloading the modules, then create a directory in /usr/local/munkireport-config/custom_modules as well and add it to your search paths:

MODULE_SEARCH_PATHS="/usr/local/munkireport-config/custom_modules/, /usr/local/munkireport/vendor/tuxudo/, /usr/local/munkireport/vendor/joncrain/"

Also remember that any module in the MODULE_SEARCH_PATHS will take precedence over the built in modules. This can be handy when trying newer versions that have not been merged into core yet!

Conclusion

As always, hit me up on Slack if you have more questions or more tips to share! Hopefully this is helpful for some!


Previous

MunkiMDM Updates

I few months back I put together a little proof of concept utilizing the MicroMDM api to control UAMDM profiles with Munki by having Munki trigger the MDM profile install.