ZoneMinder Documentation

https://github.com/ZoneMinder/ZoneMinder/graphs/contributors

Dec 25, 2018

Contents

1 Installation Guide 1 1.1 Ubuntu...... 1 1.2 Debian...... 7 1.3 Redhat...... 9 1.4 Multi-Server Install...... 13

2 User Guide 17 2.1 Introduction...... 17 2.2 Components...... 18 2.3 Getting Started...... 21 2.4 Defining Monitors...... 30 2.5 Defining Zones...... 38 2.6 Viewing Monitors...... 44 2.7 Filtering Events...... 46 2.8 Viewing Events...... 52 2.9 Options...... 55 2.10 Camera Control...... 77 2.11 Controlling Monitors...... 78 2.12 Mobile Devices...... 82 2.13 Logging...... 83

3 API 87 3.1 Overview...... 87 3.2 Security...... 87 3.3 Examples (please read security notice above)...... 88 3.4 API Version...... 88 3.5 Return a list of all monitors...... 88 3.6 Retrieve monitor 1...... 88 3.7 Change State of Monitor 1...... 88 3.8 Add a monitor...... 88 3.9 Edit monitor 1...... 89 3.10 Delete monitor 1...... 89 3.11 Arm/Disarm monitors...... 89 3.12 Return a list of all events...... 89 3.13 Retrieve event Id 1000...... 90 3.14 Edit event 1...... 90 3.15 Delete event 1...... 90

i 3.16 Return a list of events for a specific monitor Id =5...... 90 3.17 Return a list of events for a specific monitor within a specific date/time range...... 90 3.18 Return a list of events for all monitors within a specified date/time range...... 91 3.19 Return event count based on times and conditions...... 91 3.20 Configuration Apis...... 91 3.21 Run State Apis...... 91 3.22 Create a Zone...... 92 3.23 PTZ Control APIs...... 92 3.24 Host APIs...... 92

4 FAQ 93 4.1 How can I stop ZoneMinder filling up my disk?...... 93 4.2 Math for Memory: Making sure you have enough memory to handle your cameras...... 94 4.3 What does a ‘Can’t shmget: Invalid argument’ error in my logs mean? (and my camera does not display at higher resolutions)...... 95 4.4 I have enabled motion detection but it is not always being triggered when things happen in the camera view...... 97 4.5 Why can’t ZoneMinder capture images (either at all or just particularly fast) when I can see my camera just fine in xawtv or similar?...... 99 4.6 Why can’t I see streamed images when I can see stills in the Zone window etc?...... 99 4.7 I have several monitors configured but when I load the Montage view in FireFox why can I only see two? or, Why don’t all my cameras display when I use the Montage view in FireFox?...... 100 4.8 Why is ZoneMinder using so much CPU?...... 100 4.9 Why is the timeline view all messed up?...... 101 4.10 How much Hard Disk Space / Bandwidth do I need for ZM?...... 101 4.11 When I try and run ZoneMinder I get lots of audit permission errors in the logs and it won’t start... 102 4.12 How do I enable ZoneMinder’s security?...... 102 4.13 Why does ZM stop recording once I have 32000 events for my monitor?...... 102 4.14 Managing system load (with IP Cameras in mind)...... 103 4.15 Building ZoneMinder...... 105 4.16 Extending Zoneminder...... 106 4.17 Trouble Shooting...... 107 4.18 Miscellaneous...... 111

5 Contributing 113

6 Indices and tables 115

ii CHAPTER 1

Installation Guide

Contents:

1.1 Ubuntu

Contents

• Ubuntu – Easy Way: Ubuntu 16.04 – Easy Way: Ubuntu 14.x – Harder Way: Build Package From Source – Hints

* Make sure ZoneMinder and APIs work with security * Socket_sendto or no live streaming * Changed Default DB User

1.1.1 Easy Way: Ubuntu 16.04

These instructions are for a brand new ubuntu 16.04 system which does not have ZM installed. It is recommended that you use an Ubuntu Server install and select the LAMP option during install to install Apache, MySQL and PHP. If you failed to do this you can achieve the same result by running: tasksel install lamp-server

1 ZoneMinder Documentation

During installation it will ask you to set up a master/root password for the MySQL. Step 1: Either run commands in this install using sudo or use the below to become root sudo-i

Step 2: Upd