Domotz Agent Installation on Raspberry Pi
This section contains a few tips and tricks on how to get started with the Domotz Agent on your Raspberry Pi.
Installing the Domotz Agent
Option A: Installing the Domotz Agent on Raspbian
If you have a brand new Raspberry PI with no OS, here a useful article explaining how to install Raspian.
Once Raspbian is installed you can proceed with the following steps.
Make sure your Raspberry Pi is connected to the internet. We recommend using a network cable and connect your Raspberry Pi directly to your router.
Download the latest Domotz Agent for Raspberry Pi.
If you use the built-in web browser in Raspbian, go to the Domotz Community to download the latest Domotz Agent. The file should automatically end up in the /usr/home/Downloads
Click on Menu, Accessories, Terminal. A command line window with some green and blue text should appear on the screen. In case of headless installation, just login to your Raspberry Pi via a terminal. Go to the download directory (if you’re not already there) by typing cd Downloads and hitting enter.
Type the following command to install the Domotz Agent. Note that in place of you need to type the name of the file you downloaded. As Raspbian is a Linux based OS, you can simply type the first couple of letters of the file name and then hit the tab key on your keyboard and the rest of the text will be automatically filled in for you.
sudo dpkg -i <package name>
The installer for the Domotz Agent should now be running. The installation will take anything between five and 15 minutes, as the installer is downloading parts of the software and installing it onto your memory card.
Once the installation has finished, the Agent will be automatically started and you’ll see a link that you can either double click to open in a browser, or copy and paste into your browser to continue the setup.
Option B: Installing the Domotz Agent from the Snap Store
A more powerful method to install Domotz PRO on your Raspberry is to install it from the Snap store. If you don’t have it already, you need to install the Snapcraft store first:
sudo apt-get update sudo apt-get install snapd
Install the Domotz PRO Agent from the Snapcraft store as follows:
sudo snap install domotzpro-agent-publicstore sudo snap connect domotzpro-agent-publicstore:firewall-control sudo snap connect domotzpro-agent-publicstore:network-observe sudo snap connect domotzpro-agent-publicstore:raw-usb sudo snap connect domotzpro-agent-publicstore:shutdown sudo snap connect domotzpro-agent-publicstore:system-observe sudo sh -c 'echo tun >> /etc/modules' sudo modprobe tun
And comment one line at this file /etc/ld.so.preload to disable a module that conflicts with the snap package
sudo nano /etc/ld.so.preload
*Just add a # at the beginning of the line.
Restart the Domotz Pro agent service:
sudo snap restart domotzpro-agent-publicstore
This preloaded module conflicts with the snap package causing VPN on Demand not to work.
First time setup
The next step is to configure your Domotz Agent. To do so, make sure you’ve downloaded and installed the Domotz App on your mobile device. Then simply tap on the drawer menu button and tap on “Find New Agents” towards the bottom of the menu. This will automatically detect any new Domotz Agents on your network, as long as your mobile device is connected to the same network as your Domotz Agent. You can then proceed to configure your Domotz Agent following the steps below on your mobile device without having to know the IP address of your Domotz Agent.
Alternatively, you can type in the IP address and port shown in the Domotz App in a web browser on your PC. For example, if the IP address was 192.168.1.39 you type 192.168.1.39:3000 and then hit enter. You should now see the Domotz Agent webpage.
At this point, you’ll be asked to create an account if you don’t already have one. Please follow the on-screen instructions.
If you already have a Domotz account, you can login straight away. Otherwise, you can create a domotz account signing up from here (please make sure you specify the right Country):
Once logged in you can finally activate your agent, with the following steps:
- Assign a name to the Agent
- Specify whether you run the agent at home or office
- Press the “Activate your agent” button
Once this has been done, the Domotz Agent will proceed to scan your network for devices. This will take anything from a few minutes up to 15 minutes depending on how many devices you have on your network.