|Setting name||Example value(s)||Explanation|
|nodeName||homecontrolX||In individual node name for the raspberry.
|networkNameOrAddress||homecontrolX | 192.168.0.55||In individual node hostname or its ip address.
|usePlain||true | false||Listen for unencrypted connections.
|useSsl||true | false||Listen for encrypted connections. I suggest you do not use encryption for initial testing, but activate it later after the general setup is working.
|sslDebug||true | false||In case of SSL problems where you don't know the reason, activate this.
|listenPortPlain||36735||The port where the daemon is supposed to listen for incoming unencrypted connections.
|listenPortSsl||36736||The port where the daemon is supposed to listen for incoming encrypted connections.
|keystoreFilename||keystore.jks||The filename of the java keystore. Only required if SSL is used anywhere.
|keystorePassword||keystorePassword||The password of the java keystore.
|DEPRECATED - Use databaseServerNames now -
The servername or IP address where the Mysql database is running.
|databaseServerNames||servername1;servername2||The servername or IP address where the Mysql database is running. Separate multiple servers with semikolons. If you use multiple servers you need to take care of data sync yourself!
|databasePort||3306||The database port.
|databaseName||homecontrol||The name of the database.
true | false
Do you have sensors attached?
Enter sensors in the database now (table "sensors"). If you had sensors in your config file during update they have been migrated to the database. - Device type, gpio pin, watch for rising/falling
|Setting name||Example value(s)||Explanation|
|authenticationMode||ldap | mysql||Authentication source|
|dateFormat||dd.MM.yyyy HH:mm:ss:SSSS||Dateformat, especially for logs. Consult this page for documentation.|
|logLevel||1-5||Log level, the higher the more details will be logged.
1 = basic information like daemon start/stop, also all critical errors
2 = actions like devices switched or users logged on
3 = details about actions
4 = network communication
5 = SQL related events
|logMaxSize||number||Maximum size of log file in megabytes.
|ldapBasePath||CN=Users,DC=my,DC=domain,DC=name||LDAP base path|
|ldapDomain||domain name||LDAP windows domain, will be linked with user name.|
|ldapHosts||dc1.mydomain:389;dc2.mydomain:389||List of LDAP servers with port. Separate multiple ones with semikolons.|
|ldapMailAttribute||mail||Mail attribute for a user in LDAP database|
|ldapMemberGroup||CN=HomeControl,CN=Users,DC=my,DC=domain,DC=name||LDAP path of usergroup that is allowed to connect to Homecontrol|
|ldapUserAttribute||samAccountName||LDAP attribute that holds the user's username|
|ldapUseSsl||true | false||Use SSL for connections to LDAP servers? Remember to check the port in the server list of you change this. Keep in mind the root CA's certificate that signed your LDAP server's certificate needs to be in a keystore.|
|ldapCacheRefresh||60||Because the connection to an LDAP server can take a moment that'll delay login time the server will remember a user's credentials in memory for a couple of minutes. After that time has passed it'll check if they are still correct. If not the next login attempt of that user will take a moment longer because the LDAP server will be contacted again. Set this value to 0 to deactivate caching.|
|maximumLoggedInUsers||20||Maximum amount of simultaneous incoming connections.|
|notificationsEnabled (used to be mail)||true | false||Send emails in case of events? Not in use, yet.|
|notificationVerbosity)||1 - 5||The higher the more notifications will be sent.|
|notificationFromAddressemail@example.com||Sender address for notifications.|
|notificationToAddressfirstname.lastname@example.org||Recepient address for notifications.|
|notificationMailServer||smtp.provider.org||Mailserver used for admin notifications. In general for email settings start the server with the -testEmailNotification parameter to test email notifications.|
|notificationMailServerPort||25||Port of notification mail server. Encrypted is currently not supported, yet. Please wait for the next version.|
|notificationEncryptionType||NONE | STARTTLS | TLS | SSL||Encryption type used in smtp connection.|
|notificationAuthenticate||true | false||Use authentication (username/password) to send emails.|
|notificationUsername||username||Username of notification mail server.|
|notificationPassword||password||Password of notification mail server.|
|serverRelay||true | false||Relay commands to other servers|
|serverRelayAutoDisconnectTime||60000||Time in ms after which to disconnect from other nodes. Connection will be kept open for this amount of milliseconds in case the client sends more commands than just one.|
|serverRelayClientTimeout||5000||Timeout in ms for relay connection attempts.|
|serverRelayPsk||asdlfkjsadkfjsldfjlskdjf||Password that server nodes use to authenticate each other.|
|serverRelayUseSsl||true | false||Decides if RelayConnections will be established using SSL (if you have multiple nodes). Remember to enter all nodes into "nodes" table and set the correct ports.|
|switchAttempts||1 - 5||The amount of attempts to switch devices.|
|switchRoomDelay||0||If you send mass commands (like switch all devices in a room) and multiple nodes send commands at almost the same time I've noticed problems which may be because of signal collisions. A node will wait a random fraction of this number of milliseconds before sending commands.|