Retrying the Upgrade Process

Oct 13, 2025 by wbrum.org 138 views

Introduction

Snipe-IT is a popular open-source IT asset management system that helps organizations track and manage their IT assets. However, users have reported issues with upgrading Snipe-IT via composer on the latest release, v18.0. In this article, we will explore the possible causes of the issue and provide a suggested path forward to resolve the problem.

The Issue

@rotogorderee has reported that upgrading Snipe-IT via composer fails on the v18.0 appliance. The issue is not specific to the composer upgrade process, but rather a cascading effect of the need for PHP 8.2+.

Possible Causes

My suspicion is that the composer problems are related to the need for PHP 8.2+. Although I may be wrong, it is possible that the issue is caused by the fact that Snipe-IT requires a higher version of PHP to function properly.

Suggested Path Forward

To resolve the issue, I suggest attempting to update PHP to version 8.2 and retrying the upgrade process. TurnKey has a script for updating PHP, called tkl-upgrade-php, which is included in most LAMP-based appliances. However, it is not clear if Snipe-IT is one of those appliances. Nevertheless, I will provide instructions on how to install and use the script.

Installing `tkl-upgrade-php`

To install tkl-upgrade-php, follow these steps:

Check if turnkey-upgrade-php is available already:

turnkey-php-upgrade

If the response is bash: turnkey-php-upgrade: command not found, then install it and try again:

URL=https://raw.githubusercontent.com/turnkeylinux/common/refs/heads/18.x/overlays/php
SCRIPT=usr/local/bin/tkl-upgrade-php
wget $URL/$SCRIPT -O /$SCRIPT
chmod +x /$SCRIPT

Upgrading PHP

After installing tkl-upgrade-php, run the script to upgrade PHP to version 8.2. The script is interactive, so follow the prompts to select the PHP version to install. You can check Snipe-IT's documentation for the latest PHP version support and update to that version.

Retrying the Upgrade Process

After upgrading PHP, retry the upgrade process from #2017. Although the git and chown commands should not be required, it is a good idea to rerun them to ensure that the upgrade process is complete. In other words:

cd /var/www/snipe-it

turnkey-composer install --no-dev --prefer-source
turnkey-composer dump-autoload
turnkey-artisan migrate
turnkey-artisan config:clear
turnkey-artisan route:clear
turnkey-artisan cache:clear
turnkey-artisan view:clear

If the upgrade process still fails, please post back @rotogorderee and I will have a closer look ASAP.

Future Improvements

As an aside, but vaguely; making it easy to update and install tkl-upgrade-php (inc updating PHP version support) are on the todo list. The relevant issues are:

#2023
#2024

These issues will be addressed in future releases to make it easier to update and install tkl-upgrade-php and to ensure that Snipe-IT is compatible with the latest PHP versions.

Conclusion

Introduction

In our previous article, we explored the issue with upgrading Snipe-IT via composer on the latest release, v18.0. We also provided a suggested path forward to resolve the problem. In this article, we will answer some frequently asked questions (FAQs) related to the issue.

Q: What is the cause of the issue with upgrading Snipe-IT via composer?

A: The cause of the issue is likely related to the need for PHP 8.2+. Although I may be wrong, it is possible that the issue is caused by the fact that Snipe-IT requires a higher version of PHP to function properly.

Q: How do I update PHP to version 8.2?

A: To update PHP to version 8.2, you can use the tkl-upgrade-php script. This script is included in most LAMP-based appliances and can be installed and run to update PHP to the latest version.

Q: How do I install `tkl-upgrade-php`?

A: To install tkl-upgrade-php, follow these steps:

Check if turnkey-upgrade-php is available already:

turnkey-php-upgrade

If the response is bash: turnkey-php-upgrade: command not found, then install it and try again:

URL=https://raw.githubusercontent.com/turnkeylinux/common/refs/heads/18.x/overlays/php
SCRIPT=usr/local/bin/tkl-upgrade-php
wget $URL/$SCRIPT -O /$SCRIPT
chmod +x /$SCRIPT

Q: What are the steps to retry the upgrade process after updating PHP?

A: After updating PHP, you can retry the upgrade process by running the following commands:

cd /var/www/snipe-it

turnkey-composer install --no-dev --prefer-source
turnkey-composer dump-autoload
turnkey-artisan migrate
turnkey-artisan config:clear
turnkey-artisan route:clear
turnkey-artisan cache:clear
turnkey-artisan view:clear

If the upgrade process still fails, please post back @rotogorderee and I will have a closer look ASAP.

Q: What are the future improvements planned for `tkl-upgrade-php`?

A: As an aside, but vaguely; making it easy to update and install tkl-upgrade-php (inc updating PHP version support) are on the todo list. The relevant issues are:

#2023
#2024

These issues will be addressed in future releases to make it easier to update and install tkl-upgrade-php and to ensure that Snipe-IT is compatible with the latest PHP versions.

Q: What should I do if the upgrade process still fails after retrying?

A: If the upgrade process still fails after retrying, please post back @rotogorderee and I will have a closer look ASAP. I will work with you to resolve the issue and ensure that Snipe-IT is updated successfully.

Conclusion

In conclusion, the issue with upgrading Snipe-IT via composer on the v18.0 appliance is likely caused by the need for PHP 8.2+. To resolve the issue, we provided a suggested path forward to update PHP to version 8.2 and retry the upgrade process. We also answered some frequently asked questions related to the issue. If you have any further questions or concerns, please do not hesitate to reach out.