OdooWiki OCA HUB

Storage Image Backend Migration

storage_image_backend_migration folder_open OCA/storage open_in_new
Product License: AGPL-3

Action wizard that allow migrate from a source backend to destination backend.

auto_awesome What this module does

AI-generated from the code · Odoo 15.0

Lets you move all stored images and thumbnails from one storage backend to another. You pick the source and destination backends in a wizard and the transfer runs in the background.

This module adds a migration wizard that copies image and thumbnail files from one storage backend to another. You open it from the storage backend screen (the action is bound to the storage.backend model), choose the backend that currently holds the images, choose the destination backend, and optionally set how many files are handled per background job.

When you click Migrate, the wizard collects every storage.file of type image or thumbnail belonging to the source backend, splits them into chunks, and queues one background job per chunk on a dedicated job channel. Each job reads the file content from the source backend, detects its MIME type, creates a new file record on the destination backend, and then updates the related storage.image or storage.thumbnail record so it points to the new file. The old file record is then deleted.

Because the work is queued, large migrations do not block the user interface. The wizard is a transient screen with Migrate and Cancel buttons, and it is available to all users (no group restriction in the access rules).

Depends on

storage_filestorage_imagequeue_job
Models and fields (1)
  • storage.image.backend.migration.wizard · new modelchunk_size, storage_backend_id, source_storage_backend_id

Text generated by AI (DeepSeek) from reading the Odoo 15.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 3 confirmed, 6 with no information of 9 versions.

terminal Installation and usage

OCA documentation · Odoo 15.0

Usage

Source · Odoo 15.0
  • Go to Settings > Technical Settings > Storage Backend
  • Select source backend, run Migrate Backend Action
  • Select destination backend
  • Select chuck size and run

Queue jobs will be created automatically.

NOTE:

Default Backend Storage system parameter needs to be changed manually to change backend system.

No verified information in OCA: Installation, Configuration.

info

Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.