ansibleguy.sw_zoneminder/README.md

2.1 KiB

ZoneMinder

Ansible Role - ZoneMinder

Ansible Role to deploy a ZoneMinder IP-CAM server.

Read into the official documentation on how to add ip-cams and so on.

Tested:

  • Debian 11

Functionality

  • Package installation

    • ZoneMinder Server
  • Configuration

    • Default opt-ins:

      • Database setup
      • Webserver setup
    • Default opt-outs:

      • Admin-tools
    • Default config:

      • Logging to syslog
      • Self-Signed certificate

Info

  • Warning: THIS ROLE IS NOT YET IN A STABLE STATE!

  • Note: this role currently only supports debian-based systems

  • Note: Most of this functionality can be opted in or out using the main defaults file and variables!

Setup

For this role to work - you must install its dependencies first:

ansible-galaxy install -r requirements.yml

Usage

Config

Define the zoneminder dictionary as needed.

Example 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
      #  if you use 'selfsigned':
      #    cert:
      #      cn: 'ZoneMinder Server'
      #      org: 'AnsibleGuy'
      #      email: 'zoneminder@template.ansibleguy.net'
    letsencrypt:
      email: 'zoneminder@template.ansibleguy.net'
  
  

Bare minimum example:

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

You might want to use 'ansible-vault' to encrypt your passwords:

ansible-vault encrypt_string

Execution

Run the playbook:

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

There are also some useful tags available:

  • config
  • install
  • db