Versions

Odoo releases a new version every year

Upgrade

Upgrading allows you to enjoy the latest features and functionality

Hosting

The Upgrade process depends on your hosting type

Using the command line

Use the below command on the machine where your database is hosted:
python <(curl -s https://upgrade.odoo.com/upgrade) test -d <your db name> -t <target version>

Advantages of using the command line

  • Faster upload and download

  • Faster dump and restore thanks to the parallelization (see --jobs in the Postgresql documentation)

  • See the logs in real-time, to have an overview of the progress

  • Resume-able in case of interruption

If you still prefer using the upload form, the process below describes the necessary steps.

Using the upload form

Buy Odoo Enterprise
(Suggested format: pg_dump -F c -f <DB_NAME>.dump <DB_NAME> )
Testing

A new database will be created to test

Production

It replaces your production database by the upgraded one after you restore it

Process

  1. Testing Stage
    • Dump your database and request an upgrade by filling in this form (select purpose "Testing").

    • After a successful upgrade*, you will be sent an email with a link to the upgraded dump. Download it and restore it.

    • Thoroughly test all processes and workflows and report any discrepancies via the helpdesk.

  2. Production Stage
    • Once the testing has been completed and you didn't detect any inconsistencies, you can proceed to upgrade your database on production within 3 days after the test upgrade.

    • Dump your database and request an upgrade by filling in this form (select purpose "Production").

    • After a successful upgrade*, you will be sent an email with a link to the upgraded dump. Download it and restore it, then reconfigure Odoo to use the newly restored, upgraded database.

* If the upgrade fails and you are unable to resolve the issue yourself, please submit a ticket via the helpdesk
Find detailed upgrade documentation and the FAQ here

Using the upload form

Buy Odoo Enterprise
(Suggested format: pg_dump -F c -f <DB_NAME>.dump <DB_NAME> )
Testing

A new database will be created to test

Production

It replaces your production database by the upgraded one after you restore it

Process

  1. Testing Stage
    • Download a backup dump from odoo.sh (purpose "Testing", without filestore).

    • Request an upgrade by filling in this form (select purpose "Testing").

    • After a successful upgrade*, you will be sent an email with a link to the upgraded dump. Download it and restore it onto a staging branch (fork of your production branch).

    • Thoroughly test all processes and workflows and report any discrepancies via the helpdesk.

  2. Production Stage
    • Once the testing has been completed and you didn't detect any inconsistencies, you can proceed to upgrade your database on production branch within 3 days after the test upgrade.

    • Download a backup dump from odoo.sh (purpose "Exact dump", without filestore).

    • Request an upgrade by filling in this form (select purpose "Production").

    • After a successful upgrade*, you will be sent an email with a link to the upgraded dump. Download it and restore it onto your production branch.

* If the upgrade fails and you are unable to resolve the issue yourself, please submit a ticket via the helpdesk
Find detailed upgrade documentation and the FAQ here

Process

  1. Go to your database manager:

    odoo.com/web/login
  2. Click on your profile icon and select "My Databases"

    My Databases
  3. Click on the action settings icon next to your main database where you will find the "Upgrade" option (test or production)

    In the pop-up message that will appear, you will be given the option to choose:
    • a test upgrade request, which will give you an upgraded copy of your database for testing
    • OR
    • a production upgrade request, that will upgrade your live database to the new version.
  4. This will trigger the automated upgrade process which upon successful completion will send you an email with a link to either your upgraded test database or to confirm that your upgraded production database is ready (on the same web address).

Find detailed upgrade documentation and the FAQ here