[Action required] Please upgrade your Flow nodes to v0.39.0 by 31st March 2025

Hello Flow node operators,

Please upgrade your Flow node(s) to docker tag v0.39.0 (or one of v0.39.0-without-adx, v0.39.0-without-netgo-without-adx, v0.39.0-arm) and restart the node by end of this month - 31st, March 2025. This applies to ALL node roles (access, collection, consensus, verification and execution).

This is a rolling upgrade required to perform a zero-downtime Protocol State Upgrade in the first week of April. Nodes which are not updated to v0.39.0 will halt after the Protocol State Upgrade.

Do not delete the data folder.

If you are running multiple nodes, please update the nodes one at a time waiting for a few seconds between each update.


Additional instructions for Pebble Directory

This upgrade introduces a new flag called --pebble-dir. If not set, the value for the flag will default to /data/protocol-pebble. No action is needed unless you observe the error below.

If you see the following error:


could not create pebble db (path: /data/protocol-pebble): mkdir /data: permission denied"

then please do one of the following:

  1. Provide read-write access to the user of the node software process to the data directory so that the node software can automatically create the protocol-pebble directory.

    a. If you are using Docker this can be done by given read-write access to the data directory on the host machine via the volume mount,

    -v /path/to/data:/data:rw

  2. Alternatively, you can manually create a directory and pass it as the value to the --pebble-dir flag.

The pebble directory will eventually store the Pebble database for the node software as we transition to using PebbleDB from BadgerDB.


Thank you,

Flow Team

1 Like