Skip to content

Safeboot Partition Layout ~

This page is specific to ESP32 and variants (not applicable to ESP8266)

This feature was introduced in Tasmota v12

Safeboot partition layout is a new feature in Tasmota v12 that optimizes the use of Flash memory and allows for bigger filesystems and bigger firmware sizes.

Flash_layout_original Flash_layout_safeboot Flash_layout_safeboot_alt

Before v12~

Tasmota used a standard partition layout consisting of 2 firmware partitions of equal sizes. One partition is active and is booted from, while the other partition receives the new code when an OTA (Over The Air) update occurs.

This scheme is standard in ESP32 Arduino. Its main advantage is that it is very safe. If a power failure occurs during the OTA update, the device is not bricked and reboots on the untouched version. The main drawback is that it consumes a lot of flash space, enough to contains twice the firmware size.

Flash_layout_original Example, standard Tasmota layout for 4MB flash:

  • a fixed size 64KB system area
  • 2x partitions of 1856KB each to receive Tasmota code
  • a filesystem of 320KB







Introducing Safeboot~

We introduced a new variant of Tasmota called "Safeboot". It contains a minimal version of Tasmota used only for OTA, and a normal firmware. The main advantage is that it provides 1024KB of additional storage for firmware and/or filesystem.

Flash_layout_safeboot Example of new partition layout since v12:

  • a fixed size 64KB system area
  • a Safeboot partition of 832KB
  • 1x partition of 2880KB to receive Tasmota code
  • a filesystem of 320KB







Flash_layout_safeboot_alt

An alternate partition scheme is used in Sonoff Zigbee Bridge Pro:

  • a fixed size 64KB system area
  • a Safeboot partition of 832KB
  • 1x partition of 1856KB to receive Tasmota code
  • a filesystem of 1344KB





Note: the Safeboot firmware is a reduced version of Tasmota containing only what's required for OTA updates (Web UI, MQTT, TLS...). However it does not save settings nor support initial Wi-Fi configuration.

Tip

If even Safeboot is not enough for your self compiled large firmware (e.g. with webcam, LVGL, Tensorflow, Bluetooth, ...) it is possible to override the partition scheme in your build environemnt in platformio_tasmota_cenv.ini with:
board_build.partitions = partitions/esp32_partition_app3904k_fs3392k.csv # this is already part of Tasmota.