Submit Feedback
Legacy Knowledge Base
Published Sep. 10, 2025

Auto Upgrade in DXP 7.3 and Above

Written By

Alberto Chaparro

How To articles are not official guidelines or officially supported documentation. They are community-contributed content and may not always reflect the latest updates to Liferay DXP. We welcome your feedback to improve How To articles!

While we make every effort to ensure this Knowledge Base is accurate, it may not always reflect the most recent updates or official guidelines.We appreciate your understanding and encourage you to reach out with any feedback or concerns.

Legacy Article

You are viewing an article from our legacy "FastTrack" publication program, made available for informational purposes. Articles in this program were published without a requirement for independent editing or verification and are provided"as is" without guarantee.

Before using any information from this article, independently verify its suitability for your situation and project.

Issue

Starting from Liferay 7.3, new upgrades for modules won't run automatically on startup by default.

Resolution

The following options are available to run the upgrades we may include in fix/service packs:

  • Recover the old behavior with the property upgrade.database.auto.run set to true (not recommended in production environments unless you make the proper backups and remove the property just after the upgrade completion). This property is more complete than the previous autoUpgrade in com.liferay.portal.upgrade.internal.configuration.ReleaseManagerConfiguration.config since it covers the Core upgrades too. More information in breaking changes.
  • Run the upgrade tool
  • Run the upgrades using the Gogo Shell

There are a few exceptions that need to be considered:

  • Upgrades to initialize new service builder modules always run automatically.
  • For development environments, the property upgrade.database.auto.run in portal-developer.properties is set to true by default

Please note that fix packs can only contain micro schema version changes which are optional, so you will only be required to run upgrades when installing service packs that contain minor upgrade processes, using one of the options discussed above. Complete instructions will be published in Help Center when releasing fix/service packs.

Additional Information

This decision was made to unify the behavior between modules and Core and to let users decide when to run upgrade processes.

For additional information please also see the following article or contact Liferay Support: Upgrade Processes for Fix Packs in DXP 7.3 and Above

Did this article resolve your issue ?
Legacy Knowledge Base
Did this article resolve your issue ?