Upgrading Orangescrum Versions

Orangescrum frequently releases new updates for features, performance, and security. Keeping your instance up-to-date ensures you benefit from the latest improvements.

Before Upgrading

  1. Take a full backup of both database and uploads.
  2. Notify users and schedule downtime.
  3. Note your current version (Settings → About Orangescrum).

Upgrade Steps (Docker Method)

Pull the latest image:

docker pull orangescrum:latest

1. Stop existing containers:


docker compose down

2. Start new containers with updated image:


docker compose up -d –build

3. Verify the version from the web UI.

Upgrade Steps (Manual Installation)

  1. Backup /config and /uploads.
  2. Download the latest release from Orangescrum’s release page or your customer portal.
  3. Replace application files except /config and /webroot/uploads.
  4. Run database migration scripts if included.

Restart web services:


sudo systemctl restart apache2

Version Compatibility: Always check the release notes for required PHP or DB version changes before upgrading.

For enterprise users, staging upgrades are highly recommended.