[go: up one dir, main page]
Skip to Content
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

Option 1: 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>

The following command can be used to show the general help and the main commands:
python <(curl -s https://upgrade.odoo.com/upgrade) --help

To show help for a specific command (for example, test):
python <(curl -s https://upgrade.odoo.com/upgrade) <command> --help

* For production upgrades, use the command production instead of test.

Advantages of 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.
Option 2: using the upload form below
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 via upload form
  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.
Option 1: using Odoo.SH upgrade tool
For full details please check the online docs for Odoo.sh upgrades.

  1. Go to your Odoo.sh project: odoo.sh

  2. Click on the branch on which you want the upgraded database - a staging branch for testing purposes and the master branch for the production upgrade.

  3. Find the UPGRADE tab in the menu bar*, select the version you would like to upgrade to and click on Test Upgrade (it will read Start Upgrade on the master branch).

    Note: For a test upgrade (staging branch) this will always trigger an upgrade of the latest daily production back-up (it will not consider manual back-ups).

  4. Once the upgrade of the database is finished, it will prompt you to push a commit** in order to incorporate any customisations you might have (push an empty commit if you don't have any). This will trigger a restore/update of the build and make the database accessible

Once you are satisfied with the results of your tests, follow the same steps for the production upgrade on your master branch.

* If you do not find the option to use Odoo.SH upgrade tool you can continue to use the upload form.
** You can watch a video here that shows how to push a commit.
Advantages of Odoo.SH upgrade tool

  • Automatic upload and restore of DB dumps sent to the upgrade platform.

  • Faster dump and restore of production upgrades.

  • Automatically triggered custom modules upgrade.

  • Strict checks and report of errors from the logs.

Option 2: using the upload form below
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 via upload form
  1. Testing Stage

    • Download a backup dump from odoo.sh (purpose "Exact dump", 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 documentation and the FAQ here.
Option 1: directly from your database

  1. Click on your user profile in the top right corner, and select "My Subscription".

  2. Go to the Upgrade section.

  3. Refer to instructions described in our Documentation.

My Subscription
Common process

Either option will trigger the automated upgrade of your DB. Once completed successfully, you will receive an email containing a link to your upgraded test database or a confirmation that your upgraded production database is ready (accessible at the same web address). To launch the final production deployment, please refer to the instructions provided in our documentation.

Option 2: from your portal

  1. Go to your Database Manager and sign in as the database administrator.

  2. Click on your profile icon and select "My Databases".

  3. Click on the gear icon of the selected database, then click "Manage".

  4. Select Upgrade in the Database section.

  5. In the popup:

    • Select the desired Odoo version for the upgrade, which is usually the latest version.

    • Enter the email address for notifications. A link to the upgraded database will be sent to this address.

    • Select the upgrade purpose. For your first upgrade request it can only be "test".

    • Click "Upgrade".

My Databases
Manage

If you need further assistance, feel free to contact our support. Be sure to indicate that you are already a customer and requesting help with the upgrade.

Find detailed documentation and the FAQ here.