Skip to main content

Import an Existing Odoo Backup

If you are migrating from another Odoo host or from a local instance, you can upload an existing backup and restore it directly into one of your branches.

note

Importing a backup requires the Admin role on the project.

Supported format​

The import accepts a .zip archive in the standard Odoo backup format, the same file you get from Odoo's built-in Database Manager → Backup (/web/database/manager), or from another Skysize deployment's Download button.

An Odoo backup zip contains:

  • dump.sql: the PostgreSQL database dump
  • a filestore/ folder, uploaded files and attachments
  • manifest.json: version and module metadata

Because this is Odoo's native format, backups exported from a standard Odoo instance can be imported without any conversion.

caution

The import accepts a single .zip archive. Other archive formats (for example .tar.gz, or a bare .sql file) are not supported by the import flow, re-export from Odoo as a zip first.

Import the backup​

  1. Open your project and go to the Backups tab.
  2. Click Import Backup.
  3. In the Import Backup modal, select the Target branch to restore into.
  4. Choose your .zip backup file.
  5. Click Upload & Restore.

Skysize uploads the file, registers it as a backup, and immediately queues a restore on the target branch. You can follow the progress on the deployment (click View Logs). When it finishes, the branch restarts on the restored database.

caution

Importing replaces the entire database of the target branch. If you want to keep its current data, create a manual backup of that branch first.

:::note Upload size limit The import uploads through your browser and is limited to 500 MB per file. For larger databases, exclude the filestore from the export to reduce the size, restore a smaller dump first, or contact support for help with large migrations. :::

Things to check before importing​

  • Odoo version: the backup should match the Odoo version configured on the target branch. Restoring a dump taken from a different major version can fail or leave the database in a state that needs migration.
  • Edition: if the backup comes from an Odoo Enterprise database, make sure the target branch is also set to Enterprise so the enterprise modules are available.
  • Custom modules: if the database uses custom modules, make sure those modules are present in the branch's repository before you restore, otherwise Odoo may report missing modules on start-up.