Module for managing a Ubiquiti UniFi Controller.
Joshua K

Joshua K



5,422 latest version

5.0 quality score

Version information

  • 0.0.3 (latest)
  • 0.0.2
  • 0.0.1
released Jul 3rd 2019
This version is compatible with:
  • Puppet Enterprise 2019.8.x, 2019.7.x, 2019.5.x, 2019.4.x, 2019.3.x, 2019.2.x, 2019.1.x, 2019.0.x, 2018.1.x, 2017.3.x, 2017.2.x, 2017.1.x, 2016.5.x, 2016.4.x
  • Puppet >= 3.7.0
  • Debian

Start using this module


jmkeyes/unifi — version 0.0.3 Jul 3rd 2019

Puppet Unifi Controller Module

Puppet Forge Build Status

Table of Contents

  1. Overview
  2. Description
  3. Todo


This is a Puppet module to manage and deploy a Ubiquiti UniFi controller from the vendor APT repositories. It currently targets the latest stable release of Puppet, and should support Debian family distributions (like the vendor).


To use this module, use either an include-like or resource-like declaration:

# An include-like declaration for Hiera integration.
include ::unifi

# A resource-like declaration for manual overrides.
class { '::unifi': }

This module is intended to work with Puppet 4.x.


All configuration can be handled either through Hiera or by arguments to the unifi class.

UniFi Controller (using manifests)

# Install a UniFi Controller:
class { '::unifi': }

UniFi Controller (using Hiera)

# In Hiera configuration:
  - 'unifi'


  • Log rotation rules for logs located at ${::unifi::data_path}/logs.
  • Custom fact for UUID written to system properties after first boot.
  • Custom configuration for known usable parameters.