Meilisearch

Snapshot import from incompatible version causes index_scheduler decoding failure

critical
configurationUpdated Sep 16, 2024(via Exa)
Technologies:
How to detect:

When upgrading Meilisearch versions, importing snapshots from a previous version causes persistent 'index_scheduler: internal: decoding failed.' errors. The service becomes unresponsive, returning HTTP 500 errors for all operations including listing indexes. Errors repeat continuously (approximately once per second).

Recommended action:

Do not use snapshot imports when upgrading between Meilisearch versions. Instead, use the dump/restore mechanism: (1) Create a dump via REST API before upgrading, (2) Stop the old instance, (3) Upgrade the binary, (4) Start the new instance and import the dump. Snapshots are not forward-compatible across versions.