7. Files and Directories

7.1. Directories

Homegear creates the following directories:

/etc/homegear
├── devices
└── families
/usr/share/homegear
└── firmware
/var/lib/homegear
├── audio
├── families
├── flows
├── modules
├── phpinclude
├── scripts
├── tmp
└── www
/var/log/homegear

Directory	Description
/etc/homegear	Homegear’s configuration files
/etc/homegear/devices	XML files containing the device descriptions
/etc/homegear/families	Family configuration files
/usr/share/homegear	Static files. Currently the firmware updates are placed here.
/var/lib/homegear	Data directory
/var/lib/homegear/audio	Audio files
/var/lib/homegear/families	Family specific data
/var/lib/homegear/flows	Node-BLUE data
/var/lib/homegear/modules	Family modules
/var/lib/homegear/phpinclude	Default PHP include directory. You can place libraries here to make them available in all PHP files.
/var/lib/homegear/scripts	Place your custom scripts in this directory
/var/lib/homegear/www	Homegear’s web root directory. Place files or PHP scripts you want to be served through Homegear’s webserver here.
/var/log/homegear	Homegear’s log files

7.2. Configuration files

The following configuration files can be found in /etc/homegear:

/etc/homegear
├── dh1024.pem
├── homegear.crt
├── homegear.key
├── homegear-start.sh
├── homegear-stop.sh
├── influxdb.conf
├── main.conf
├── mqtt.conf
├── php.ini
├── rpcclients.conf
└── rpcservers.conf

File	Description
dh1024.pem	Diffie-Hellman parameters used for forward secrecy
homegear.crt	RPC server SSL certificate
homegear.key	RPC server SSL private key file
homegear-start.sh	This script is executed before Homegear starts. You can add your own initialization commands here.
homegear-stop.sh	This script is executed after Homegear is stopped. You can add your own deinitialization commands here.
influxdb.conf	Homegear InfluxDB’s configuration file. Only available when Homegear InfluxDB is installed.
main.conf	Homegear’s main configuration file
mqtt.conf	MQTT configuration file
php.ini	Configuration file for Homegear’s PHP script engine
rpcclients.conf	File to configure RPC event servers (certificates, authentication, …)
rpcservers.conf	RPC and web server configuration file