Upgrading to 2026.10

This page lists the steps needed to upgrade a deployment from 2026.02.x to 2026.10.0. The release notes on the GitHub releases page summarize the same changes together with new features and fixes.

Work through the sections that apply to your deployment. Then validate the configuration with manager --check --config <yaml> before the first start.

Manager settings and the configuration database

Schema migration 4 of the configuration database drops the SETTING table. The database holds module configurations only; manager settings (installation paths, MQTT broker and prefixes, telemetry, schema validation and exception forwarding) come from a settings file or the deprecated settings: block of the configuration file.

  • manager --db <file> without --settings or --config runs with the built-in defaults for every setting. A database created by 2026.02.x with a non-default broker or prefix loses those values on the automatic migration.

  • Keep non-default settings in a settings file and pass it with --settings <file>. The option works with or without --config and --db. The file is validated against schemas/settings.yaml and rejects unknown and deprecated keys: drop www_dir, controller_port, controller_rpc_timeout_ms, prefix and config_file, and see Linux capabilities for run_as_user. The installed examples etc/everest/settings-mqtt-tcp.yaml, settings-mqtt-uds.yaml and settings-all-options.yaml are a starting point. See Manager Settings.

  • The settings: block of the configuration file is deprecated. It still applies with --config as long as --settings is not given; with --settings it is ignored with a warning.

  • Tools that read the database directly must follow the new schema: a CONFIG table, composite primary keys, and renumbered MUTABILITY and DATATYPE ids. Configurations marked invalid (CONFIG_META.VALID = 0) are deleted during the migration.

File-based SQLite databases, including the configuration, OCPP and device model databases, use WAL journal mode. Back up the -wal and -shm files together with the .db file, or checkpoint the database first.

See Manager Command Line Options and EVerest Configuration Service.

Manager command line

  • Options must be spelled in full. Abbreviated spellings no longer parse.

  • --conf is a deprecated alias of --config and cannot be combined with it. Replace it in start scripts and service units.

  • manager --check requires --config. Change health checks and CI jobs to manager --check --config <yaml>. The check needs no MQTT broker and does not touch the configuration database.

  • --db-init has no effect and is deprecated. Seeding the database from the YAML configuration is the default when the database holds no valid configuration.

Linux capabilities

The manager no longer grants Linux capabilities to modules. The capabilities key of a module entry in the configuration file is ignored and logs a warning. This change did not go through a deprecation period and is an exception to the deprecation policy. Modules declare the capabilities they need in their manifest.yaml, and the deployment grants them as file capabilities.

  • On Yocto, use the everest_file_capabilities class of meta-everest.

  • Elsewhere, run applications/utils/scripts/set_module_capabilities.py after installing.

This affects deployments that run the manager as an unprivileged user and use EvseSlac, PacketSniffer, Setup or Huawei_V100R023C10. settings.run_as_user is deprecated as well: start the manager as the unprivileged user from the service manager, for example with User=everest in the systemd unit. See Security Best Practices.

EvseSecurity writes private keys with mode 0600 and restricts the key directories to 0700. Run modules that read key files, such as the OCPP and ISO 15118 modules, as the same user as EvseSecurity.

Module configuration

The following configuration values fail validation or change meaning:

Module and key

Change and action

RsIskraMeter read_meter_values_interval_ms

Limited to 1000–4000 ms, default 2000 ms. Lower larger values.

Evse15118D20 negative_bidirectional_limits

Defaults to true, so ISO 15118-20 discharge limits are sent as negative values. Set it to false to keep positive limits.

EvseManager ac_limit_slac_init_retries

Defaults to true, which limits SLAC retries as ISO 15118-3 requires. Set it to false for unlimited retries.

EvseManager lock_connector_in_state_b: false

Deprecated. Use unlock_when_deauthorized: true.

RsIskraMeter implementation_id: meter

Deprecated. Connect to implementation_id: main.

Evse15118D20 logging_path

Deprecated and without effect, since the session logger was removed. Delete it.

EvseManager also treats errors from the SLAC and ISO 15118 modules as faults: anything other than generic/VendorWarning makes the EVSE Inoperative.

Replacing deprecated modules

Two module families are deprecated in 2026.10.0 and may be removed in 2027.04.0:

Replacing a module changes the module set of the configuration. Parameters changed at runtime are persisted outside the configuration file, in the user-config or the configuration database, and EVerest does not carry them over to the successor module. Persisted Configuration Changes describes what to do for each storage mode.

ISO 15118 EV simulation

PyEvJosev is removed and replaced by Ev15118, the EV side of the C++ ISO 15118 stack. Change module: PyEvJosev to module: Ev15118 and map the config_module keys with the table in Configurations written for PyEvJosev.

  • supported_protocols must be set. It has no usable default, and the module refuses to start until it lists at least one of ISO15118_20, ISO15118_2 and DIN70121.

  • start_charging takes DepartureTime in seconds from the call and EAmount in kWh. 0 states none, and negative or non-finite values are rejected.

  • A DC or MCS start_charging is rejected unless set_dc_params has given a positive max_power_limit, max_current_limit and max_voltage_limit. A set_dc_params call that leaves a field out keeps its previous value, and a call with an invalid value is rejected whole.

  • Out-of-tree modules that provide ISO15118_ev must implement three new commands:

    • abort_charging: terminate the V2G session immediately, without the SessionStop exchange.

    • cp_state_changed: the control pilot state the vehicle applies; E or F during a session terminates it without SessionStop.

    • update_present_values: the electrical values the EV currently measures.

OCPP 2.x component configuration

  • InternalCtrlr.ChargePointId and InternalCtrlr.NumberOfConnectors are removed from the component configuration, and existing device-model databases drop them on the next start. Neither was used for the connection; the station identity comes from SecurityCtrlr.Identity as before. In OCPP 1.6 mode NumberOfConnectors is provided by OCPP16LegacyCtrlr. A CSMS or tool that reads either variable through GetVariables or GetBaseReport gets UnknownVariable.

  • Network connection profiles live in per-slot NetworkConfiguration_<N> components. An existing InternalCtrlr.NetworkConnectionProfiles value is migrated once at startup, see Migration from legacy NetworkConnectionProfiles. Provision new deployments through NetworkConfiguration_<N>.json.

  • minLimit and maxLimit stored in an existing device-model database are kept, so changed limits in the shipped component configuration apply only to new databases. SecurityCtrlr.SecurityProfile accepts 0 regardless of a stored minimum.

  • InternalCtrlr.EnableTLSKeylog is ReadOnly. Set it in the component configuration instead of through SetVariables.

  • The device model holds its values in memory and writes changes through to the database. Edit the device-model database only while EVerest is stopped; changes made while it runs are not seen until the next start. An attribute marked "persistent": false in a custom component configuration is no longer stored.

Building and packaging

  • EVerest builds from the repository root only. It installs the CMake packages everest-base, everest-iso15118, everest-ocpp and everest-core, selected with EVEREST_PACKAGES, and all targets are named everest::<name>. Remove EVEREST_LIBS_ONLY, EVEREST_INCLUDE_LIBS, EVEREST_EXCLUDE_LIBS, EVEREST_IO_WITH_MQTT and the per-library *_INSTALL and *_BUILD_TESTING options; configure fails with them. Builds with EDM install no CMake packages, so consumers that use find_package() install from a -DDISABLE_EDM=ON build.

  • everest-cmake 0.9 or newer is required. The install_everest_testing target is removed.

  • Rust modules need Rust 1.86 or newer.

  • The CMake options EVEREST_ENABLE_ADMIN_PANEL_BACKEND and EVEREST_INSTALL_ADMIN_PANEL are removed.

  • The Josev wheel targets are removed, and the development PKI no longer contains Java keystores (.jks).

Yocto

  • Recipes shared between Yocto releases live in the meta-everest-common layer, which meta-everest adds automatically. They use ${UNPACKDIR}. Update bbappends that refer to ${WORKDIR} paths of everest-core or ev-cli.

  • The compatibility recipes everest-framework, everest-sqlite, libcbv2g, libevse-security, libfsm, libiso15118, liblog, libocpp, libslac and libtimer, the asyncapi backport recipe and the admin-panel packages are removed. Drop them from IMAGE_INSTALL, DEPENDS and RDEPENDS.

  • Josev’s recipe python3-iso15118 and the recipes only it pulled in, openjdk, python3-aiofile, python3-caio, python3-environs, python3-marshmallow, python3-netifaces, python3-packaging, python3-poetry-core, python3-py4j, python3-pydantic, python3-python-dotenv and python3-typing-extensions, are removed. Drop them from IMAGE_INSTALL and RDEPENDS and delete bbappends for them.

  • everest.service runs the manager with the configuration database /var/lib/everest/everest.db and the settings file settings-mqtt-uds.yaml, and with systemd meta-everest configures Mosquitto for a Unix domain socket. Edits of config.yaml take effect only until the database is initialized, and /var/lib/everest has to persist across root file system updates.

See Building Yocto for your custom hardware, including its systemd service section for the service and the Mosquitto setup.

EVerest APIs

  • evse_board_support (all BSP drivers, evse_board_support_API included): EvseManager requests state X1 only with cp_state_X1. Until 2026.10 most paths already did, but a duty cycle of 100 % (for example a current limit below 6 A in basic AC charging) was sent as pwm_on(100). pwm_on is only called with a duty cycle strictly between 0 and 100 %.

  • evse_board_support_API and system_API: commands without arguments (cp_state_X1, cp_state_F, cp_state_E, lock, unlock, self_test, allow_firmware_installation) carry an empty JSON object {} as payload, like the other APIs, instead of an empty payload. Clients that tested for an empty payload must accept {}.

  • All EVerest API modules and the configuration and lifecycle APIs: a request without headers.replyTo is executed and its reply discarded, as before, but without a warning. A request is now rejected without being executed if it is not a JSON object, if headers is not an object (null included), or if replyTo is not a string, not publishable (empty, +, #, NUL, leading $) or in a namespace EVerest subscribes or publishes to (everest/..., everest_external/nodered/..., and in everest_api everything but topics at least two levels below e2m). Before, such requests were executed and their reply was dropped, delivered as another request or published as if it came from EVerest. A client that replies to everest_api/.../e2m/<operation> without a unique level of its own below it must add one, e.g. e2m/<operation>/<uuid>. See EVerest APIs. In everest_api_types, generic::RequestReply::replyTo and the reply_to argument of deserialize_request are std::optional<std::string>; replies are sent with MqttProviderInterface::publish_reply, which publishes nothing when there is no replyTo.

  • All EVerest API modules: a number that does not fit the type it is stored in (usually a 32-bit signed integer or a single-precision float) is rejected. Before, an integer such as 4294967297 wrapped (to 1 for a connector id) and a number beyond about 3.4e38 became infinity.

  • All EVerest API modules: a field declared as format: date-time has to be an RFC 3339 date-time with a UTC offset, between 1677-09-21T00:12:43.146Z and 2262-04-11T23:46:49.854Z. Anything else, such as a date-time without an offset or 9999-12-31T23:59:59Z, makes EVerest discard the message with a warning; a request gets no reply. Before, such values were forwarded unchecked and read as 1970, as the current time or with their offset ignored. For an open end, such as timestamp_to in an error history filter, use the latest accepted value 2262-04-11T23:46:49.854Z.

  • power_supply_DC_API: EVerest now sends currents below min_export_current_A and min_import_current_A, including 0 A, when the EV asks for less than the offered minimum. Earlier releases raised them to the minimum. A client must then deliver no current and must not raise the request to the minimum, see everest_modules_handwritten_power_supply_DC_API.

The deprecated topics keep working until 2027.04.0 at the earliest. See Active Deprecation Index for the full list, including:

  • ocpp_consumer_API: replace is_connected with connection_status, and use component/variable addressing instead of OCPP 1.6 key-only addressing, see Migration from OCPP 1.6 key addressing.

  • evse_manager_consumer_API: replace the evse_id topics with get_evse.

  • error_history_consumer_API: stop relying on severity and severity_filter.

  • API module: move to the EVerest API modules.

API modules publish compact JSON. Only clients that compare raw payload strings are affected.

API modules raise the initial CommunicationFault, and EvseManager its Inoperative, only if no communication_check arrives within cfg_communication_check_to_s, no longer right at start.