Migrations
A migration turns a backup of an Odoo that runs somewhere else into an environment here.
What you can import
Section titled “What you can import”- A backup
.zipfrom Odoo.sh or from Odoo’s database manager (database and filestore). - A PostgreSQL dump (
.dump, made withpg_dump). - An SQL file (
.sqlor.sql.gz).
Before you start
Section titled “Before you start”- 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. Import the backup
Section titled “1. Import the backup”- Open Migrations in the sidebar and press Import a backup.
- Step 1: choose Where it comes from and give the import a Name (small letters, digits and
-, for exampleshop-odoosh). - 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.
- Step 3: choose The server that checks it, usually the server it will run on.
- Press Check it.
2. The check
Section titled “2. The check”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.
3. Deploy it
Section titled “3. Deploy it”- On the import’s row, press the deploy action.
- Choose the Project (the same Odoo version), a Name for the new environment, the Server and the Type.
- 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.
- Start it.
A new environment is created and filled from the import.
Afterwards
Section titled “Afterwards”- 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.

