Skip to content

Configuration

Calin Crisan edited this page Jan 18, 2020 · 23 revisions

Topics


qtoggleserver.conf

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 nano editor:

     # nano /data/etc/qtoggleserver.conf
    
  • insert the SD card into your Windows or OSX laptop and provide your qtoggleserver.conf file on the boot partition

  • insert the SD card into your Linux laptop and edit the /etc/qtoggleserver.conf file on the data partition

See Partitions for more details on the partitions layout.

System Settings

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:

Device Name

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.

Administrator Password, Normal Password and View-only Password

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

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.

System Date/Time

The system date/time is automatically managed by the OS so you should change it via the app.

Timezone

Choose the correct timezone of your device, so that the local time is used when writing time-based automation rules.

WiFi Configuration

Since you're already viewing the app Settings page, your qToggle device has network access, whether wired or wireless. Nevertheless, you can change or remove your WiFi network name and password using this field. Be sure to enter data correctly so that you don't break the device's network access.

IP Configuration

Since you're already viewing the app Settings page, your qToggle device has a working IP configuration. You may want though to set up a static IP using this field. Be sure to enter data correctly so that you don't break the device's network access.

OS Configuration

Clone this wiki locally