{"id":11014,"date":"2020-12-20T18:21:48","date_gmt":"2020-12-20T23:21:48","guid":{"rendered":"https:\/\/myriad.ca\/?p=11014"},"modified":"2022-08-20T07:19:21","modified_gmt":"2022-08-20T11:19:21","slug":"zm-docker-ubuntu20-04","status":"publish","type":"post","link":"https:\/\/myriad.ca\/index.php\/2020\/12\/20\/zm-docker-ubuntu20-04\/","title":{"rendered":"Zoneminder Docker Install on Ubuntu 20.04"},"content":{"rendered":"[vc_row type=”in_container” full_screen_row_position=”middle” column_margin=”default” column_direction=”default” column_direction_tablet=”default” column_direction_phone=”default” scene_position=”center” text_color=”dark” text_align=”left” row_border_radius=”none” row_border_radius_applies=”bg” overflow=”visible” overlay_strength=”0.3″ gradient_direction=”left_to_right” shape_divider_position=”bottom” bg_image_animation=”none”][vc_column column_padding=”no-extra-padding” column_padding_tablet=”inherit” column_padding_phone=”inherit” column_padding_position=”all” column_element_direction_desktop=”default” column_element_spacing=”default” desktop_text_alignment=”default” tablet_text_alignment=”default” phone_text_alignment=”default” background_color_opacity=”1″ background_hover_color_opacity=”1″ column_backdrop_filter=”none” column_shadow=”none” column_border_radius=”none” column_link_target=”_self” column_position=”default” gradient_direction=”left_to_right” overlay_strength=”0.3″ width=”1\/1″ tablet_width_inherit=”default” animation_type=”default” bg_image_animation=”none” border_type=”simple” column_border_width=”none” column_border_style=”solid”][vc_column_text]This tutorial will enable you to install Zoneminder 35.16 on Ubuntu 20.04 using a Docker container. Docker, in my opinion, represents a further abstraction of the software architecture and thus makes a simple operation more complex. But while it is tricky to initially set up, once you do it, it works well. Anecdotally, I have noticed on two BHYVE virtual servers I have built this project on, I find the Docker version runs much more efficiently that a traditional install and that the server load is less than half when run inside the Docker container.<\/p>\n
\n
\n
\n
\n
\n
\n

Firstly, I created this version on TrueNAS v. 12 using a virtual BHYVE instance which, having worked with KVM vm’s previously, I find the FreeNAS\/TrueNAS virtual servers MUCH easier to use, snapshot and work with. Though if you are using other platforms, this tutorial should work for you as well. This tutorial assumes you have created an instance with one cpu and eight GB of ram and a 100gb virtual disk for the OS and a 500 GB or greater volume for camera storage (use ‘virtio’ if you’re using BHYVE). This how-to works with Ubuntu 20.04, though it should work on other distros\/UB versions, ymmv. It assumes that you have Docker installed and properly tested. If you are new to Docker, click on this link<\/a> for a quick tutorial to get you up and running. So let’s get started:<\/p>\n<\/div>\n<\/div>\n

\n
\n

Here are the steps I followed to get Zoneminder 35.16 on Ubuntu 20.04:<\/p>\n

1 – Pull docker image:<\/p>\n<\/div>\n<\/div>\n

\n
\n
\n
\n
 docker pull dlandon\/zoneminder.master<\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
\n
\n
2 – Open a ssh command prompt and run the command below to create the Zoneminder container. For more information on the different options set below click here<\/a>. Copy the command below as one block of text and paste it into the command window (change the timezone option and the \/mnt\/ option to suit your environment (**see step 6 below<\/span> for more info about mounting external drives before<\/em> you press enter):<\/p>\n<\/div>\n<\/div>\n
\n
\n
\n
\n
docker run -d --name=\"Zoneminder\" \\\n--net=\"bridge\" \\\n--privileged=\"true\" \\\n-p 8080:80\/tcp \\\n-p 8443:443\/tcp \\\n-p 9000:9000\/tcp \\\n-e TZ=\"America\/Toronto\" \\\n-e SHMEM=\"50%\" \\\n-e PUID=\"99\" \\\n-e PGID=\"100\" \\\n-e INSTALL_HOOK=\"0\" \\\n-e INSTALL_FACE=\"0\" \\\n-e INSTALL_TINY_YOLOV3=\"0\" \\\n-e INSTALL_TINY_YOLOV4=\"0\" \\\n-e INSTALL_YOLOV3=\"0\" \\\n-e INSTALL_YOLOV4=\"0\" \\\n-e NO_START_ZM=\"1\" \\\n-v \"\/mnt\/Zoneminder\":\"\/config\":rw \\\n-v \"\/var\/cache\/zoneminder\":\"\/var\/cache\/zoneminder\":rw \\\ndlandon\/zoneminder.master<\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
\n
\n
\n
\n
docker logs -f Zoneminder 'check progress of install<\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
\n
\n
3 – After the Zoneminder container is installed we need to fix the MariaDB instance, which on my installation at least, didn’t run and generated an error, resulting in Zoneminder not starting. So enter bash shell on your docker instance:<\/p>\n<\/div>\n<\/div>\n
\n
\n
\n
\n
docker exec -it Zoneminder \/bin\/bash<\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
\n
\n
Remove the zm database:<\/p>\n<\/div>\n<\/div>\n
\n
\n
\n
\n
    mysql -u root -p 'enter mysql \n\tMariaDB [(none)]> SHOW DATABASES; 'list databases\n\tMariaDB [(none)]> DROP DATABASE IF EXISTS zm; 'delete existing zm db\n\tMariaDB [(none)]> exit;<\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
\n
\n
4 – Now create new zm db (root password is empty, but you can change it if you wish) and start mysql and Zoneminder<\/p>\n<\/div>\n<\/div>\n
\n
\n
\n
\n
mysql -uroot -p < \/usr\/share\/zoneminder\/db\/zm_create.sql\nservice mysql start\nservice zoneminder start\nexit 'quit the bash shell<\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
\n
\n
5 – Now we need to adjust the NO_START_ZM=”1″<\/strong> environment variable so Zoneminder will start automagically when the container in started. I know you can spawn a new container with the modified variable and delete the old one AND rename the modified one, etc. But I prefer to edit the json and just modify the existing container (see my abstraction comment in the preamble). Find your container and edit it as follows to remove: ,”NO_START_ZM=1″ to “NO_START_ZM=0” from the “Env”:[] section and save.<\/p>\n<\/div>\n<\/div>\n
\n
\n
\n
\n
docker container ls -a  'list containers\ndocker container stop Zoneminder '[CONTAINER ID] or [container name]  'stop your container\nnano \/var\/lib\/docker\/containers\/[your container]\/config.v2.json<\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
\n
\n
6 – If you adjusted the variables in step 2 above you can skip this step, but I just wanted to provide readers with some context as to why we set these particular settings and what they do. Zoneminder, by its design uses a lot of disk space which is stored by default in the ‘\/var\/cache\/zoneminder\/events’ folder. Now it is not a good idea to put this folder on the same drive as your ‘\/’ folder due to the fact that if your hard drive fills up completely, your system will die. So I like to mount an additional drive just to store the camera recordings and associated data.<\/span><\/p>\n
The json syntax is as follows: {“Source”:”[\/my_external_drive]”,”Destination”:”\/var\/cache\/zoneminder” <\/strong>*remember, \/mnt\/zoneminder is mounted internally inside your container by default so you want to change that line to your external drive which you have previously mounted to your vm. Change the line: ,”MountPoints”: and change {“Source”:”\/mnt\/zoneminder”,”Destination”:”\/var\/cache\/zoneminder”<\/strong> to {“Source”:”\/var\/cache\/zoneminder”,”Destination”:”\/var\/cache\/zoneminder”<\/strong> Also, using this step will allow those of you who need to mount more than one storage volume to your container do so easily by adding more mount points.<\/p>\n<\/div>\n<\/div>\n
\n
\n
\n
\n
 docker container ls -a  'stop your container\nnano config.v2.json 'See editing details above \nservice docker restart 'restart docker service and check your newly mounted volume for zm directories\ndocker container start Zoneminder 'start it up\ndocker logs -f Zoneminder 'check logs for errors<\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
\n
\n
7 – Now we have Zoneminder up and running we need to make it reachable from the outside world. To do this we are going to set up apache2 outside the container, configure a Let’s Encrypt certificate for it and establish a proxy connection to our webserver inside the Docker container which we have set up to listen on ports 8080 and 8443.<\/p>\n<\/div>\n<\/div>\n
\n
\n
\n
\n
sudo apt install apache2 'install apache2\nsudo a2enmod proxy\nsudo a2enmod proxy_http\nsudo a2enmod rewrite\nsudo a2enmod ssl\nsudo a2enmod proxy_balancer\nsudo a2enmod lbmethod_byrequests 'install needed apache mods\nsudo a2ensite zm.example.com 'put your domain here\nsudo systemctl restart apache2<\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
\n
\n
8 – Create a Let’s Encrypt Certificate.<\/p>\n<\/div>\n<\/div>\n
\n
\n
\n
\n
# Install certbot:\nsudo apt install python3-certbot-apache\n# Issue the following command to create e certificate:\nsudo certbot --apache 'Follow the prompts. Certbot will find our zm.example.com domain and create a cert.<\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
\n
\n
9 – Set up the zm.example.com.conf file. Paste the following below into zm.example.com.conf replacing existing text. Adjust servername and your local host’s IP (don’t use ‘localhost’)<\/p>\n<\/div>\n<\/div>\n
\n
\n
\n
\n
     \n\u2039VirtualHost *:80\u203a\n     ServerName zm.example.ca\n\nRewriteEngine on\nRewriteCond %{SERVER_NAME} =zm.example.ca\nRewriteRule ^ https:\/\/%{SERVER_NAME}%{REQUEST_URI} [END,NE,R=permanent]\n\u2039\/VirtualHost\u203a\n\u2039VirtualHost *:443 *:30001 *:30002 *:30003 *:30004 *:30005\u203a\n\n    ServerName zm.example.ca\n            SSLEngine On\n        \tSSLProxyEngine On\n    \n            Order deny,allow\n            Allow from all\n    \n    ProxyRequests On\n    ProxyPreserveHost On\n        ProxyPass \/zm\/ http:\/\/10.40.10.67:8080\/zm\/\n        ProxyPassReverse \/zm\/ http:\/\/10.40.10.67:8080\/zm\/\n        ProxyPass \/ http:\/\/10.40.10.67:8080\/zm\/\n        ProxyPassReverse \/ http:\/\/10.40.10.67:8080\/zm\/\n\nProxyPreserveHost On\n\u2039\/VirtualHost\u203a\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
\n
\n
10 – Enable ssmtp for sending mail from Zoneminder<\/p>\n<\/div>\n<\/div>\n
\n
\n
\n
\n
docker exec -it Zoneminder \/bin\/bash 'get into the shell\nsudo nano \/etc\/ssmtp\/revaliases 'edit ssmtp options<\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
\n
\n
Add the following below to your revaliases file (change your settings to suit)<\/p>\n<\/div>\n<\/div>\n
\n
\n
\n
\n
\t\t# sSMTP aliases\n# \n# Format:\tlocal_account:outgoing_address:mailhub\n#\n# Example: root:your_login@your.domain:mailhub.your.domain[:port]\n# where [:port] is an optional port number that defaults to 25.\nroot:zm@example.com:smtp.mailgun.org:587\nwww-data:zm@example.com:smtp.mailgun.org:587\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
\n
\n
Now edit your ssmtp file.<\/p>\n<\/div>\n<\/div>\n
\n
\n
\n
\n
# Are users allowed to set their own From: address?\n# YES - Allow the user to specify their own From: address\n# NO - Use the system generated From: address\nFromLineOverride=NO\nroot=zm@mg.example.com\nmailhub=smtp.mailgun.org:587\nhostname=localhost\nRewriteDomain=mailgun.org\nUseSTARTTLS=YES\nUseTLS=YES\nAuthUser=zm@mg.example.com\nAuthPass=[your_PW]<\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
\n
\n
Test your mail.<\/p>\n<\/div>\n<\/div>\n
\n
\n
\n
\n
sudo echo \"Subject: sendmail test\" | sendmail -v me@example.com 'send a test\nsudo ln -s \/usr\/bin\/ssmtp \/usr\/lib\/sendmail 'sym link for zm<\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
\n
\n
Still not working as you expect? Check out the log files by running #<\/span>docker logs -f Zoneminder before you post a comment. Still not working? \u00a0Just telling me, ‘it’s not working’, does not provide enough information to troubleshoot your problem. You wouldn’t take your car into the garage and say, “my car doesn’t work!” – you need to give me some clues to help you fix your problem. Check your steps carefully, every command has to be issued as it is shown in the how to. If you find any mistakes please let me know and I will fix them right away.<\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/section>\n<\/div>\n
 [\/vc_column_text][\/vc_column][\/vc_row]\n","protected":false},"excerpt":{"rendered":"
[vc_row type=”in_container” full_screen_row_position=”middle” column_margin=”default” column_direction=”default” column_direction_tablet=”default” column_direction_phone=”default” scene_position=”center” text_color=”dark” text_align=”left” row_border_radius=”none” row_border_radius_applies=”bg” overflow=”visible” overlay_strength=”0.3″ gradient_direction=”left_to_right” shape_divider_position=”bottom” bg_image_animation=”none”][vc_column column_padding=”no-extra-padding” column_padding_tablet=”inherit” column_padding_phone=”inherit” column_padding_position=”all” column_element_direction_desktop=”default” column_element_spacing=”default” desktop_text_alignment=”default” tablet_text_alignment=”default”…<\/p>\n","protected":false},"author":2,"featured_media":11863,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[469],"tags":[],"class_list":{"0":"post-11014","1":"post","2":"type-post","3":"status-publish","4":"format-standard","5":"has-post-thumbnail","7":"category-linux"},"_links":{"self":[{"href":"https:\/\/myriad.ca\/index.php\/wp-json\/wp\/v2\/posts\/11014","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/myriad.ca\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/myriad.ca\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/myriad.ca\/index.php\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/myriad.ca\/index.php\/wp-json\/wp\/v2\/comments?post=11014"}],"version-history":[{"count":11,"href":"https:\/\/myriad.ca\/index.php\/wp-json\/wp\/v2\/posts\/11014\/revisions"}],"predecessor-version":[{"id":12765,"href":"https:\/\/myriad.ca\/index.php\/wp-json\/wp\/v2\/posts\/11014\/revisions\/12765"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/myriad.ca\/index.php\/wp-json\/wp\/v2\/media\/11863"}],"wp:attachment":[{"href":"https:\/\/myriad.ca\/index.php\/wp-json\/wp\/v2\/media?parent=11014"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/myriad.ca\/index.php\/wp-json\/wp\/v2\/categories?post=11014"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/myriad.ca\/index.php\/wp-json\/wp\/v2\/tags?post=11014"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}