Configuration

IN PROGRESS!

Web application configuration

Recommended configuration method. Alternative in YAML below.

The main way to configure boneIO Black is the web interface available at https://device-ip-address:8443. The web interface provides:

• Live preview of inputs, outputs, and sensors, including their changes,
• Modbus communication tools and device preview,
• Settings panel for full configuration of all controller aspects,
• YAML editor with a text editor for YAML files and real-time validation,
• Real-time log preview,
• System panel for updates, backups, and administrative functions,
• Multi-language support (English/Polish),

Configuration

YAML Editor

You can also manually edit YAML configuration files if needed. All configuration files are located in the ~/boneio/ directory.

# Example YAML configuration
mqtt:
  host: "your-mqtt-broker"
  port: 1883

Starting with version 1.x.x, full device configuration is possible via a "clickable" web interface. This greatly simplifies and speeds up the controller configuration process. However, the configuration is still based on a YAML file. By default, it is named config.yaml. YAML supports file nesting, which makes it more readable. When you see:

key: !include file.yaml

This means that the key section will be loaded from the file.yaml file.

The boneIO application supports several sections.

key: !include_files file.yaml file2.yaml file3.yaml

This means that the key section will be loaded from 3 files: file.yaml, file2.yaml, file3.yaml.

key: !include_dir_list directory

This means that the key section will be loaded from all files in the directory directory.