-
Notifications
You must be signed in to change notification settings - Fork 1
Configuration
qToggleServer is configured via the qtoggleserver.conf file that lives in /data/etc. At first boot it is copied from /etc/qtoggleserver.conf which is a system-provided default configuration.
To edit the configuration file you can:
-
log in remotely using SSH and use the
nanoeditor:# nano /data/etc/qtoggleserver.conf -
insert the SD card into your Windows or OSX laptop and provide your
qtoggleserver.conffile on the boot partition -
insert the SD card into your Linux laptop and edit the
/etc/qtoggleserver.conffile on the data partition
See Partitions for more details on the partitions layout.
qToggleOS can store data using one of the various available persistence drivers, which correspond to different underlying technologies, ranging from simple JSON files to database servers. Choosing one particular persistence driver is an important matter and should be done based on the way your qToggleOS setup will be used.
One important thing to note is that while a plain qToggleServer installation will use the JSON driver by default, a freshly installed qToggleOS is configured to use PostgreSQL, which offers all possible functionalities (except for Raspberry Pi 1st generation and Zero, where Redis is used by default).
See the Select Persistence Driver page for details on available drivers and reasons to choose one or another.
After choosing your desired driver, use the qtoggleserver.conf reference to actually configure the persistence driver in your qtoggleserver.conf.
There are a few system settings that can and should be adjusted via the web app. Just go to the Settings page in the app and you'll notice the following system settings:
The device name plays an important role in a master-slave qToggle setup and also represents the hostname of your board on the network. Use simple names made of non-accented letters, numbers and dashes.
Every qToggle device has the following roles:
- administrator role - unlimited privileges, used for administrative purposes
- normal role - daily, regular usage with no access to the Settings page
- view-only role - can only view the state of your qToggle device
By default, all passwords are empty. It is important to set up strong passwords for at least the administrator and normal roles, since these roles can do damage to your home automation.
The administrator password is also used when logging in remotely using SSH with user root or its alias admin. This is yet another reason for setting a strong administrator password.
Choose the correct timezone of your device, so that the local time is used when writing time-based automation rules.
Since you're already viewing the app Settings page, your qToggleOS device has network access, whether wired or wireless. Nevertheless, you can view or change your WiFi configuration using these fields. Device will reboot/reconnect soon after changes are applied. Be sure to enter data correctly so that you don't break the device's network access.
Since you're already viewing the app Settings page, your qToggleOS device has a working IP configuration. You may want though to set up a manual IP configuration using these fields. Device will reboot/reconnect soon after changes are applied. Be sure to enter data correctly so that you don't break the device's network access.
qToggleOS is based on thingOS so you'll find a lot of operating system-related information by reading the thingOS wiki.
Most of the configuration files are already provided by qToggleOS and come with default values that provide a reasonable out-of-the-box experience. There are however some optional features that you'll probably want to configure: