Skip to content

Migrations

A migration turns a backup of an Odoo that runs somewhere else into an environment here.

  • A backup .zip from Odoo.sh or from Odoo’s database manager (database and filestore).
  • A PostgreSQL dump (.dump, made with pg_dump).
  • An SQL file (.sql or .sql.gz).
  • A prepared server to check the file.
  • A default storage: the checked import is kept there as a backup.
  • A project of the same Odoo version as the backup, with the repository that holds the instance’s custom modules.

Importing needs an owner or admin.

  1. Open Migrations in the sidebar and press Import a backup.
  2. Step 1: choose Where it comes from and give the import a Name (small letters, digits and -, for example shop-odoosh).
  3. Step 2: choose how the file arrives:
    • Upload a file (up to 2 GB), or
    • A link to the file (any size): an HTTPS link. A signed download link is kept encrypted.
  4. Step 3: choose The server that checks it, usually the server it will run on.
  5. Press Check it.

The file goes to the server you chose. There it is loaded into a throwaway PostgreSQL with no network access, to prove that it loads, and the platform reads its Odoo version, its installed modules and its users. Then it is stored in your default storage as a backup of the kind “import”.

The file holds your company’s data. It goes to your own server and your own storage, nowhere else, and is kept as a backup until you delete it.

When the check is done, the import shows as ready, with what was found.

  1. On the import’s row, press the deploy action.
  2. Choose the Project (the same Odoo version), a Name for the new environment, the Server and the Type.
  3. Leave Neutralize on for a trial: mail servers and scheduled jobs are off, so the copy sends nothing. Switch it off only for the production that replaces the old one.
  4. Start it.

A new environment is created and filled from the import.

  • Sign in to the new Odoo with the users of the old one: their passwords came along with the database.
  • Point your domain at it: Addresses, your own domain and SSL.
  • Remove an import you no longer need from its row with Remove.