Domotz Pro User Guide

3.2. Installing on Other Supported Platforms

Domotz Agent is available, for free, on a number of platforms, such as: 


• Windows PC/Server

• Ubuntu 16.04 or higher

• QNAP NAS 
• Synology NAS
• ReadyNAS

• Raspberry PI for self-installation

• Virtual Machine / Virtual Server

 

Note: Installing the Agent on platforms other than the Domotz Box is not
recommended for professional monitoring because OS changes in third-party platforms
may introduce incompatibilities. In addition, we may not be able to provide
technical support and advice related to those platforms. Note that not all features
are available on third-party hardware. (special configurations, Violet device blocking,
etc.)

The Domotz Agent complete auto-update feature is only available on Domotz Box

3.2.1. Domotz Agent Installation on QNAP


To install the Domotz Agent on your QNAP:

 

  • Visit the App Center on your QNAP NAS.
  • Search for the Domotz app in the Home Automation Section.
  • Once you find the Domotz application click “Install”. Once the installation is completed click “Open”

Below are some screenshots outlining the steps in the process.

 

3.2.1.1. QNAP first time set-up

The next step is to configure your Domotz Agent.

 

By clicking Open on the first time you will be brought to the Domotz Agent activation page.

 

 

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:

 

  1. Assign a name to the Agent
  2. Specify whether you run the agent at home or office
  3. Press the “Activate your agent” button

 

 

Once this has done , the Domotz Agent will proceed scanning 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.

 

 

At this point you can download the mobile app (if you do not have already) and open it.

 

PLEASE NOTE:


By pressing “Done” you will enter the local Domotz Agent Web UI.

This is not the main Domotz app, that is accessibile from mobile apps and our website. The local Agent Web UI is only meant to provide a small subset of the Domotz features (Agent info, Network Info, Route Analsis, Speed Test).

3.2.2. Domotz Agent Installation on Synology


To install the Domotz Agent on your Synology:

 

  1. Visit the App Center on your Synology NAS.
  2. Search for the Domotz app.
  3. Once you find the Domotz application click “Install”. Once the installation is completed click “Open”

Below are some screenshots outlining the steps in the process.

3.2.2.1. Synology first time set-up

 

The next step is to configure your Domotz Agent.

 

By clicking in the Domotz Hub for the first time you will be brought to to the Domotz Agent activation page.

 

NOTE: If you can't see the Domotz Hub app don't worry. If the Domotz Package is in Running mode, please connect to port 3000 of your NAS with a web browser, like this: <NAS_IP_ADDRESS>:3000 and you'll be inside the Domotz Agent login page. Another way to install the Agent would be to download the Domotz Pro mobile App on your phone and follow the steps to Add a New Agent: the App will find the Domotz Agent running inside the NAS automatically. @4.1.1. Sidebar menu

 

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:

 

  1. Assign a name to the Agent
  2. Specify whether you run the agent at home or office
  3. Press the “Activate your agent” button

 

 

Once this has done , the Domotz Agent will proceed to scanning 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.

 

 

At this point you can download the mobile app (if you do not have already) and open it.

 

By pressing “Done” you can enter the local Domotz Agent Web UI

 

PLEASE NOTE:
By pressing “Done” you will enter the local Domotz Agent Web UI,

This is not the main Domotz app, that is accessibile from mobile apps and our website. The local Agent Web UI is only meant to provide a small subset of the Domotz features (Agent info, Network Info, Route Analsis, Speed Test)

3.2.3. Domotz Agent Installation on RASPBERRY PI

3.2.3.1. Getting started

 

This section contains a few tips and tricks on how to get started with the Domotz Agent on your Raspberry Pi. We’ll go through what you need to get going with a brand new Raspberry Pi, so if you already have Raspbian installed, you can skip straight to section @3.2.3.3. Installing the Domotz Agent‍ . The Agent is compatible with all Raspberry Pi platforms to date, as of February 2016.

 

If you bought a Raspberry Pi or pre-configured memory card from Domotz, please proceed to section @3.2.3.4. First time setup‍ , after connecting your Raspberry Pi to a power adapter and your network.

 

If your Raspberry Pi has the Snap package installed, you can simply install Domotz PRO from the Snap store, following the instructions @3.2.3.5. Install from the Snap store‍.

 

Note that your Raspberry Pi needs to have a network interface of some kind, or the Domotz Agent won’t be able to detect the devices on your network.

3.2.3.2. Installing Raspbian

 

Installing the Domotz agent on your Raspberry Pi is a a lot more involved than installing it on a NAS, due to the fact that the Raspberry Pi needs to have an OS installed on it. First, there are some pre-requisites and we’ll take you through everything you need here if you’re starting from scratch.

 

In addition to your Raspberry Pi board you’ll need a micro SD card onto which you need to install an operating system. We’d recommend getting a Class 10 or faster memory card, as it’ll make the install quicker. Another option is to buy a ready made micro SD card from the Raspberry Pi foundation. If you bought one of these, then you can skip to section @3.2.3.3. Installing the Domotz Agent‍ .

 

You’ll also need either a USB cable or a USB power adapter so you can power your Raspberry Pi, and ideally a screen of some kind with HDMI input, an HDMI cable, a mouse, a keyboard and a network cable.

 

Once you have the above things, let’s get the operating system installed. We’d recommend using NOOBS if you’re not familiar with Linux and you can download it from the Raspberry Pi foundation by going here – https://www.raspberrypi.org/downloads/ Click on NOOBS and download the “Offline and network install”.

 

The following guide explains how copy the files onto your micro SD card and how to install Raspbian – https://www.raspberrypi.org/help/noobs-setup/. This is when that monitor or TV comes into play, as once you’ve prepared the micro SD card according to the instructions, you need to plug your Raspberry Pi into the monitor and connect a keyboard and a mouse to it. After a few seconds, you should see a screen that will ask you to install the OS, simply click on Raspbian followed by Install and the OS should be installed.

 

Once the installation is done and your Raspberry Pi has rebooted, you’ll see a setup screen. You can configure some options here and we’d recommend enabling to boot into the graphical user interface. Once you’re done, simply select Finish to boot into the Raspbian desktop environment.  Now you need to connect your Raspberry Pi to your network via a network cable, so we can continue with installing the Domotz Agent.

 

Note that if you don’t make any changes in the setup menu, you can start the graphical user interface by typing “startx” and hitting enter.

3.2.3.3. Installing the Domotz Agent

 

You’re now at the point where you need to download and install the Domotz Agent on your Raspberry Pi.

 

  1. Make sure your Raspberry Pi is connected to the internet. We recommend to use a network cable and connect your Raspberry Pi directly to your router.                                                                                        
  2. Download the latest Domotz Agent for Raspberry Pi

 

If you uses 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

 

If you have a headless setup (no screen, keyboard or mouse connected), you can login to your Raspberry Pi via SSH using a terminal software such as PuTTY or Tera Term in Windows, or the built in options in OS X or Linux. The default user name is pi and the password is raspberry. Then simply type the following commands to start the download:cd Downloads

wget <file-path-as-specified-on-the-domotz-portal>

      3. Install the Agent

 

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 <package name> 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>

Note: To list files in Linux, type ls and hit enter and you’ll see the files in the current directory.

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.

 

If you want to check that everything is working properly from the command line, you can run sudo /etc/init.d/domotz status to get a status message

If you want to uninstall your Domotz Agent, simply type sudo dpkg --purge domotz and hit enter in the terminal.

3.2.3.4. First time setup

 

The next step is to configure your Domotz Agent. To do so, make sure you’ve downloaded an 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 configuring 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’re running any other web service on your Raspberry Pi that uses port 3000, the Domotz Agent will automatically use the next available port, i.e. 3001.

 

Once you’ve created your account, the Domotz Agent will proceed to scanning 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.

 

 

This also means that it’ll take some time before all of your devices appears in the Domotz App on your smartphone or tablet. Once the scan has finished, click/tap Done to continue the to the Domotz Agent web UI.

 

Note that the setup of the Domotz Agent will fail if the time and date isn’t set correctly on your Raspberry Pi. To fix this, simply update the time and date on your Raspberry Pi and you’ll be able to proceed with the setup.

 
powered by tomehost