Subversion Repositories rld.domoticz

Building Domoticz via Docker

This builder still a bit work on progress. It uses Docker to compile OpenZWave and Domoticz. To speed up the build process on macos and Windows it uses a persistent volume for the actual compilation. Currently it supports only builds to amd64 targets. Using `docker buildx` it should be possible to add architectures like Raspberry Pi.

## Prerequisites
You need to have docker-compose installed.
To install docker-compose you can use the below instructions:

### docker-compose installation ###
```shell
sudo apt install docker-compose
sudo usermod -aG docker ${USER}
exit
```

## Initial Setup

The scripts expect that you've cloned OpenZWave repository besides Domoticz like:

```shell
$ git clone https://github.com/domoticz/domoticz.git dev-domoticz
$ git clone --depth 1 https://github.com/domoticz/open-zwave.git
```

Then create the Docker image:

```shell
$ docker-compose -f dev-domoticz/build/docker-compose.yml build
```

`This can take a while as it builds CMake and Boost from source.`

## Configuration
Optionally you can use `.env.example` as a template to create an `.env` file in the same directory:

```ini
HTTP_PORT=8080
HTTPS_PORT=443

# On Windows and macOS compilation typically will go faster with:
CACHE_BIND_MOUNTS=YES

# Configure CMake:
USE_BUILTIN_JSONCPP=YES
USE_BUILTIN_MINIZIP=YES
USE_BUILTIN_MQTT=YES
USE_BUILTIN_SQLITE=YES

USE_PYTHON=YES
INCLUDE_LINUX_I2C=YES
INCLUDE_SPI=YES
WITH_LIBUSB=YES

USE_LUA_STATIC=YES
USE_OPENSSL_STATIC=NO
USE_STATIC_OPENZWAVE=YES

USE_PRECOMPILED_HEADER=YES
GIT_SUBMODULE=ON
```

Note that `USE_STATIC_BOOST` is not supported, it's always enabled.



## Build Domiticz

First generate the Domoticz Makefiles:

```shell
$ ./dev-domoticz/build/build cmake
```

Now you can build OpenZWave and Domoticz:

```shell
$ ./dev-domoticz/build/build compile
$ ls -l dev-domoticz/domoticz
-rwxr-xr-x  1 markr  staff  17540712 21 feb 23:33 dev-domoticz/domoticz
```

For testing it can be useful to run Domoticz containerized:

```shell
$ ./dev-domoticz/build/build run
```

Open http://127.0.0.1:8080/ in your browser.


## Usage

```shell
$ cd dev-domoticz/build
$ ./build
Usage:
  build clean [-p openzwave | domoticz]   # clean source
  build compile [-p openzwave | domoticz] # compile source
  build shell                             # run bash inside the container

Only for Domoticz:
  build cmake                             # (re)creates Makefiles
  build run                               # run Domoticz for testing

Only for OpenZWave:
  build check                             # validates XML configuration files
  build updateIndexDefines
  build test
```