Repository navigation
System Settings
The System Settings tab configured device-wide settings, displays system info, maintenance actions, syslog, and the LittleFS file browser. It is divided into several cards.
Read-only summary of the controller's state, refreshed on every tab load:
| Field | Description |
|---|---|
| Firmware | Currently running firmware version (e.g. 0.2.1). |
| IP Address | The device's LAN IP. |
| mDNS Name | Local hostname — ourbrewbot-<chipid>.local. The value is a link; click to open the admin page via mDNS. Shows disabled when mDNS is turned off in Global Settings. |
| WiFi SSID | The SSID the device is associated with. |
| RSSI | WiFi signal strength in dBm (closer to zero = stronger). |
| Free Heap | Free RAM in bytes. Useful for diagnosing memory leaks. |
| Uptime | Time since last boot in hours and minutes. |
| Chip ID | The ESP8266's unique chip identifier. |
A row of action buttons. All are destructive or restart the device — each requires confirmation.
| Button | What it does |
|---|---|
| Reboot | Soft-resets the device. Configuration is preserved. |
| Factory Reset | Resets all configuration to defaults (fermenter setpoints, probes, plugs, brew services, etc.). Probe addresses and identities are kept but their assignments are cleared. |
| Firmware Update | Opens /update, the OTA upload page. Upload a .bin file to flash new firmware over WiFi. |
| Reset WiFi Settings | Clears stored WiFi credentials and reboots into the WiFiManager setup portal so the device can be re-onboarded to a new network. |
| RF Sniffer | Opens the RF sniff page. Press a button on a 433 MHz remote and the page shows the code, protocol, bit length, and pulse delay — copy these into the Smart Plugs tab. |
| BT Sniffer | Opens an AT-command console for the HM-10 BLE module. Use to debug BLE / Tilt connectivity. |
| Export Config | Exports the device configuration combined in a single JSON file. WARNING Will contain passwords & API keys in plain-text. Treat this file as containing sensitive information. |
| Import Config | Imports a previously exported configuration file. Overwrites the current device config. |
The BT Sniffer page commandeers the HM-10 — don't open it during a live ferment that relies on a Tilt.
Three device-wide settings shared by every fermenter:
| Field | Description |
|---|---|
| Temp Unit | Display unit on the admin page — Celsius or Fahrenheit. Internally and over MQTT, temperatures are always in °C; this setting only affects display. |
| Resolution | DS18B20 probe resolution (9 – 12 bit). Higher = more decimal places but slower reads (≈94 ms at 9-bit, ≈750 ms at 12-bit). 12-bit is the most common choice. |
| mDNS | Enables the ourbrewbot-<chipid>.local mDNS hostname. On by default. Takes effect after reboot. See stability note below. |
| Fermenter Debug Mode | When on, each fermenter card on the Fermenters tab gains a purple Debug Overrides panel that lets you inject synthetic Beer / Ambient / SG readings. Useful for testing profile logic without real probes. Overrides are runtime-only — they reset on reboot. |
Click Save to commit. The button shows ok/error inline.
mDNS stability note: On networks with heavy mDNS traffic (many smart home devices, Apple hardware, etc.) the ESP8266 mDNS library can block the main loop for longer than the hardware watchdog timeout (~8 s), causing the device to reboot. If you observe unexplained reboots, disable mDNS here as a first step. The device is always accessible by its IP address regardless of this setting.
Sends log lines to a remote syslog server (UDP).
| Field | Description |
|---|---|
| Enabled | Master switch. |
| Host | Syslog server IP or DNS name. |
| Port | UDP port (default 514). |
| Facility | Syslog facility code — typically Local0 – Local7 for application logs. |
| Min Log Level | Suppress messages below this level. 7 Debug lets everything through; 4 Warning filters out routine info. |
Logs include fermenter state changes, plug fires, profile step transitions, brew-service uploads, MQTT events, and errors. The same lines also stream to the USB serial port and (if enabled) to MQTT via Publish Logs on the Reporting tab.
A list of every file in the device's LittleFS partition (the JSON config files that persist across reboots). Clicking a row opens the file viewer card below it — the file's contents are loaded into a textarea.
The file viewer has a Download button that saves the displayed content as a .txt file to your browser's downloads folder, useful for backing up config or for inspecting it offline.
The file viewer is read-only. To restore a backup, you currently have to re-enter the settings via the admin UI or re-flash the LittleFS partition with PlatformIO.
Typical files:
| File | Contents |
|---|---|
config.json |
Global config, fermenter settings, profiles. |
probes.json |
DS18B20 probe addresses, assignments, and offsets. |
tilts.json |
Tilt slot config. |
ispindels.json |
iSpindel slot config. |
plugs.json |
Smart plug codes and assignments. |
brewservices.json |
Brewer's Friend / Brewfather config. |
mqtt.json |
MQTT broker settings. |
syslog.json |
Syslog settings. |
- Free Heap below ~10 KB is a warning sign — restart the device if you see this persistently and report the firmware version. Healthy operation is typically 15 – 25 KB free.
-
Use mDNS (
ourbrewbot-XXXXXX.local) rather than the IP where possible — it survives DHCP lease changes. If you see unexplained reboots, try disabling mDNS in Global Settings (see stability note above). - Back up your config by exporting the configuration before upgrading the device. Config files are forward-compatible but a backup is cheap insurance.
- OTA updates preserve LittleFS. Only a full chip-erase via esptool wipes config.
- Debug Mode is for testing only. Turn it off before running a real ferment so accidental override settings don't drive control.