DE EN
← Back to project page

Download the Shelly Firmware Manager

Free

Version 1.5.0

Current published version according to the version overview.

Download firmware

How to install the manager

  1. Download and extract the firmware archive.
  2. Open the installation guide and check your hardware.
  3. Flash the firmware to the ESP32-C6.
  4. Connect the ESP32 to your Wi-Fi.
  5. Open the dashboard in a browser.

Versions

Changelog

An overview of the most important changes and new features across all versions.

Version 1.5.0
  • Automatic daily firmware check for all managed Wi-Fi devices. Starts 60 seconds after boot and then every 24 hours of uptime. Paused when Wi-Fi is unavailable and during updates or backups.
  • Firmware updates for multiple Wi-Fi devices at the same time through the web interface. Select the Stable or Beta channel, persist batch jobs atomically, and record individual reasons for skipped devices.
  • Raise the update history to a maximum of 50 managed devices and enlarge the persistent store accordingly.
  • Backup permission check already in the device list with individual reasons. A detailed check is also performed when a backup starts.
  • Manual configuration backups for supported Wi-Fi devices. Direct download of the Shelly ZIP archive in the browser and persistent storage of backup metadata including SHA-256 checksum and export status.
  • Fail-closed compatibility check for backups. Gen1 devices and documented model exclusions are reported as unsupported. Unvalidated Gen2+ models, missing authentication, and unreachable devices are classified as unknown or unavailable accordingly.
  • Mutual locking of active firmware updates and backups.
  • New API endpoints for backup compatibility, backup jobs, creation, download, cancellation, and deletion. All endpoints require manager authentication; write accesses additionally verify Same-Origin.
  • Limit backup archives to 1 MiB and transfer time to 10 minutes. SHA-256 is calculated during streaming, and an export is only marked successful after the transfer completes and the checksum is valid.
  • Host unit tests for the backup model, transport, and metadata codec.
  • Documentation of backup compatibility, the implementation plan, and the project roadmap. Link to the firmware archive in the README.
  • Public download page for firmware 1.5.0 with installation guide, checksums, sitemap, robots metadata, structured data, favicon, and IONOS Deploy Now workflow.
Version 1.3.2
  • Sequential instead of parallel querying of the web UI data endpoints for a more robust home page.
  • Improved scroll behavior of the device lists at the top and bottom edges of the page.
  • Detection of BTHome button events and display in the BLE device details.
  • BLE device filters and support for additional BTHome object types.
  • Progress-based refresh and protection against duplicate actions during firmware checks.
  • Increase the maximum number of BLE devices to 50 and improve header navigation.
  • API and web UI action to reset the update history. Resetting is prevented while updates are running or pending.
  • Split Wi-Fi and BLE devices into collapsible sections with pinned table headers and improved filters.
  • Restore the BLE scan status when the completion callback is missing and link the Wi-Fi IP addresses.
  • Improved status and progress indicators for device actions and faster refresh for running tasks.
  • Detection of active firmware updates and improved device status messages.
  • Extended BLE background scanning and decoding of additional BTHome objects.
  • OTA firmware upload through the authenticated web interface.
  • Persistent configuration storage in LittleFS, removal of embedded credentials, fixed setup access point, and optional static IP configuration.
  • BLE inventory codec and persistent storage of the device inventory.
  • Bulk firmware checks for Wi-Fi devices, removal of Wi-Fi and BLE devices, and Wi-Fi and BLE detail views in the web interface.
  • Fix the type check of serviceUuids to use JsonArrayConst.
Version 0.1.0
  • First versioned firmware release workflow for ESP32-C6.
  • Display of the firmware version, Git revision, and PlatformIO build environment through the authenticated system status API and web interface.
  • Creation of a firmware package with bootloader, partition table, firmware, JSON manifest, and SHA-256 checksums from a clean checkout.
  • Documentation on installation, recovery, configuration backup and restore, and support for device generations and models.
  • No direct BLU firmware OTA. For supported official update procedures, see the Shelly documentation.