Open Source

The OpenProject Foundation strives to make
OpenProject a place to participate and collaborate
with open source and open mind.

Upgrading your OpenProject installation (DEB/RPM Packages)

Note: this guide only applies if you've installed OpenProject using our DEB/RPM packages.

Upgrading OpenProject is as easy as installing a newer OpenProject package and running the openproject configure command.

Debian / Ubuntu

sudo apt-get update
sudo apt-get install --only-upgrade openproject
sudo openproject configure

CentOS / RHEL

sudo yum update
sudo yum install openproject
sudo openproject configure

SuSE

sudo zypper update openproject
sudo openproject configure

Re-configuring the application

Using openproject configure, the wizard will display new steps that you weren't available or configured in previous installations. If you want to perform changes to your configuration or are unsure what steps are available, you can safely run openproject reconfigure to walk through the entire configuration process again.

Note that this still takes previous values into consideration. Values that should not change from your previous configurations can be skipped by pressing <Return>. This also applies for steps with passwords, which are shown as empty even though they may have a value. Skipping those steps equals to re-use the existing value.

Upgrading between major releases (DEB/RPM packages)

Since OpenProject 6.0.0 is a major upgrade, you will need to perform some basic manual steps to upgrade your package.

If you have currently installed the stable 5.0.x release of OpenProject by using the stable/5 package source, you will need to adjust that package source.

APT-based systems (Debian, Ubuntu)

  • Update the reference to stable/5 in /etc/apt/sources.list.d/openproject.list to stable/6.
  • Perform the Upgrade steps as mentioned above in Upgrading your OpenProject installation

YUM-based systems (CentOS, RHEL)

  • Update the reference to stable/5 in /etc/yum.repos.d/openproject.repo to stable/6.
  • Perform the Upgrade steps as mentioned above in Upgrading your OpenProject installation

SUSE Linux Enterprise Server 11, 11

  • Update the reference to stable/5 in /etc/zypp/repos.d/openproject.repo to stable/6.
  • Perform the Upgrade steps as mentioned above in Upgrading your OpenProject installation

Note:

You can find the master document in GitHub. You can propose a change to this guide by creating a pull request on GitHub.