Ansible Role - ZoneMinder

This Ansible Role helps you set up a ZoneMinder IP-CAM server.

For guidance on adding IP cameras and other details, check the official documentation.

Molecule Logs

• Short Log
• Full Log

Tested on:

• Debian 11

Installation

To install the ZoneMinder role, run the following commands:

# latest version
ansible-galaxy role install git+https://github.com/ansibleguy/sw_zoneminder

# from galaxy
ansible-galaxy install ansibleguy.sw_zoneminder

# or to a custom path
ansible-galaxy install ansibleguy.sw_zoneminder --roles-path ./roles

# install dependencies
ansible-galaxy install -r requirements.yml

Usage

If you want a simple Ansible GUI, check out my Ansible WebUI.

Configuration

Customize the Zoneminder settings as needed.

Example configuration for a ZoneMinder server:

zoneminder:
  timezone: 'Europe/Vienna'
  tools: true  # install useful admin tools
  
  apache:
    domain: 'zoneminder.template.ansibleguy.net'
    aliases: ['zm.template.ansibleguy.net']

    ssl:
      mode: 'letsencrypt'  # or selfsigned/ca/snakeoil
      #  if using 'selfsigned' or 'ca':
      #    cert:
      #      cn: 'ZoneMinder Server'
      #      org: 'AnsibleGuy'
      #      email: '[email protected]'
    letsencrypt:
      email: '[email protected]'

Minimal example:

zoneminder:
  apache:
    domain: 'zoneminder.template.ansibleguy.net' 

You can use 'ansible-vault' to encrypt your passwords:

ansible-vault encrypt_string

Execution

Run the playbook with:

ansible-playbook -K -D -i inventory/hosts.yml playbook.yml --ask-vault-pass

You can also use these tags for specific tasks:

• config

Functionality

• Package Installation

  • ZoneMinder Server
    • Base package and dependencies
    • Apache2 (using this role)
    • MariaDB (using this role)

• Configuration Options

  • Default included features:

    • Database setup
    • Webserver setup

  • Default excluded features:

    • Admin tools

  • Default settings:

    • Logging to syslog
    • Self-Signed certificate

Additional Information

• Note: This role currently supports only Debian-based systems.

• Note: Most features in this role can be enabled or disabled.

  For all options available, check the default configuration in the main defaults file!

• Warning: Be sure to set a login password after the installation.