Introduction:
This guide explains how to safely upgrade OpenProject from version 15 to 16 on an Ubuntu server.
The process includes:

  • Backup
  • Package upgrade
  • Database migration
  • Service validation

This method ensures minimal downtime and data safety.

Prerequisites:
1. OpenProject 15 already installed
2. Root / sudo access
3. Internet connectivity
4. PostgreSQL running (usually auto-managed by OpenProject)

Step 1:
Take Full Backup (Mandatory)

$ pg_dump -U openproject -Fc openproject > openproject_before_upgrade.dump

Backup Attachments

$ sudo tar -czvf openproject_files_backup.tar.gz /var/db/openproject

Step 2:
Verify Current Version

$ dpkg -l | grep openproject

Step 3:
Update OpenProject Repository

$ sudo nano /etc/apt/sources.list.d/openproject.list

Replace:

stable/15

With:

stable/16

Step 4:
Upgrade OpenProject

$ sudo apt update
$ sudo apt install openproject -y

Step 5:
Run Database Migration

$ sudo openproject run rake db:migrate

Check migration status:

$ sudo openproject run rake db:migrate:status

Step 6:
Restart OpenProject

$ sudo systemctl restart openproject

Step 7:
Please verify the upgraded version.

$ dpkg -l | grep openproject

Please check the service status.

$ systemctl status openproject

Please access the web UI.

https://openprojectexample.com

Step 8:
Please perform post-upgrade validation.
1. Projects are loading
2. Users can log in
3. Attachments are accessible
4. No UI errors
Conclusion:
By following these steps, you can successfully:
1. Upgrade OpenProject 15 → 16
2. Preserve database and files
3. Ensure a stable production environment



Post Views: 7

Leave a Reply