October DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsWindows FixRecommendedWindows errors stealing your time? Find the fix fastScan stability, cleanup and performance issues.Fix NowOctober DealsAmazon USDeal season is back - check today's better picksAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
World desk10 min

How to Upgrade PHP for Nextcloud Without Breaking Your Install

Match PHP to your exact Nextcloud release, back up the database, data and configuration, then upgrade sequentially with maintenance mode and migration checks to avoid a broken install.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Upgrade PHP for Nextcloud only after you have identified the exact Nextcloud major release, confirmed that release supports the PHP version you want, and made a restorable backup. Nextcloud upgrades are sequential: update the current major release to its latest point release, then move one major release at a time, allowing background migrations to finish after each step.

The commands in this guide assume a conventional archive installation on Linux. Snap, Docker, virtual-machine images and distribution packages have their own update workflow. In every deployment, the web process and the occ command-line tool must use the same supported PHP runtime, and third-party apps must pass compatibility checks before they are enabled again.

As an Amazon Associate I earn from qualifying purchases.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Why PHP and Nextcloud must be upgraded together

Nextcloud supports a defined set of PHP branches for each server release. A PHP version that works with one Nextcloud major release may be rejected by the next release, while an older Nextcloud release may not run on a newer PHP branch at all. PHP itself also stops receiving security fixes after a branch reaches end of life. Staying on a deprecated branch restricts the syntax and dependencies available to Nextcloud and its apps, and newer PHP releases can improve execution speed.

Do not choose a PHP version by looking only at the version currently installed. First record the Nextcloud release, then consult the project’s maintained PHP matrix. The current system-requirements documentation lists PHP 8.3, 8.4 and 8.5, with PHP 8.5 recommended for the current release line; the matrix remains the authority when you are operating an older branch.

#1 Best Overall
Sale
TOZO A1 Wireless Earbuds Bluetooth 5.3 Light Weight in Ear Headphones | IPX5 Waterproof,2 Mics for AI Calls,Immersive Premium Sound Bass Headset with Charging Case,32 EQ via App Black
  • [Ultra-Lightweight Ear Buds Designed for Small Ears] Each earbud weighs only 3.7g and features a compact, ergonomic in-ear design made especially for small ears. Secure, low-profile, and comfortable for workouts, all-day wear or overnight sleeping.The ultra-slim profile sits flush in your ear with no hard edges poking or rubbing, so you can even sleep on your side without discomfort.
  • [Immersive Stereo Sound with TOZO OrigX Technology] TOZO OrigX tuning delivers clear vocals, balanced mids, and natural stereo sound for music, podcasts, and videos.
  • [Long Battery Life for Daily Use] Get up to 7 hours of playtime on a single charge, with up to 32 hours total using the charging case—ideal for workdays, commuting, and extended listening sessions.
  • [Bluetooth 5.3 & Stable Connection] Bluetooth 5.3 provides fast pairing, stable wireless performance, and reduced dropouts as you move around home or office.
  • [Deep Bass with Clear Vocals] High-performance drivers produce punchy bass while keeping vocals clean and detailed for everyday listening.

Identify your release and installation method

Find the exact Nextcloud release

In the web interface, open the Administration area and view the overview page. From a shell, change to the Nextcloud installation directory and run:

sudo -u www-data php occ status

Record the major and point release shown. The major number is the first number in a version such as 32.0.4. Also record the PHP version reported by the Administration overview and by the CLI command:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

php -v

If those two PHP versions differ, stop and correct the runtime selection before upgrading. A successful CLI test does not prove that Apache or PHP-FPM is using the same binary.

Confirm how Nextcloud was installed

  • Archive installation: you downloaded and extracted a Nextcloud archive into a web-server directory, with config/config.php and a separate data directory.
  • Snap: the service is managed by the Snap system and is updated through Snap’s Nextcloud commands.
  • Docker or another container: PHP is part of the image; changing the host PHP package does not change the container runtime.
  • Pre-built virtual machine: the appliance publisher supplies the supported update process.
  • Distribution package: the operating system’s package maintainer controls the application and PHP integration.

This article’s archive procedure should not be applied verbatim to the other methods. Use the updater and backup procedure supplied by the distribution point, while retaining the same release, compatibility and recovery principles.

PHP compatibility matrix

The following values come from the Nextcloud project’s PHP-version matrix, edited 1 September 2026. A range such as 8.2–8.5 means every minor branch from 8.2 through 8.5, not an untested future release.

Rank #2
Sale
Smart Watch for Men Women Compatible with iPhone Samsung Android Phone 1.69 inch Full Touch Screen IP68 Waterproof Bluetooh Fitness Tracker Heart Rate/Sleep Monitor (Black)
  • 【IP68 Waterproof Multifunctinal Smart Watch】Torjalph fitness activity tracker smart watch is IP68 waterproof technology ,you can wear it when swimming,handwashing,it's rain-proof which means that you perform multiple exercise modes outside without worrying about sweat or rain corroding your fitness smart watch,and this watch equipped with a 230 mAh large capacity battery magnetic charging ,and this sports activity tracker watch can be used 5-7 days If fully charged.
  • 【Larger 1.83'' Full Screen Watch & Multi-dial Selection】1.83 inch full HD color touch screen smart watch for men / women provides excellent 240*284 resolution image quality ,This Bluetooth smart watch offers a better touch experience and remarkable immersion and ,more than 200 watch faces for you to choose from App"Da Fit ", you can change the dial style according to your mood to wear keeping the world on your wrist
  • 【Accurate Activity Tracker Smart Watch 】sports watch activity tracker uses sweat and dust resistant breathable silicone strap, our Fitness Tracker Smart Watch for Android iOS Phones supports 12 sports modes,walking,running,bicycle,swimming,badminton,basketball,football,rope skipping. This bluetooth calls smart watch for men women is lightweight and stylish, bringing more convenient and relaxing sports experience while also providing more protection.
  • 【Your 24 Hour Personal Daily Health Monitor】Fitness watch for women men full touch screen IP67 waterproof bluetooth smartwatch for Android iOS Phones with heart rate blood pressure monitor multifunction Andriod smart watch with steps counter sleep monitor sports fitness watch, monitoring blood oxygen saturation allows you to understand your physical condition in real time to track fitness progress ,to know your health status in time.
  • 【More Functions Bluetooth Call Smart Watch】This fitness activity smart watch full screen for iPhone and Android phones includes a bunch of new features including:The bluetooth smart watch can hang up the phone, receive and display WhatsAPP /Text /Facebook /Twitter /Messenger reminder.Support sedentary reminder, alarm clock, stopwatch, timer,weather information,music control, remote camera control compatible with Android 5.0 and above or iOS 9.0 and above smartphones.
Nextcloud release Supported PHP branches
35 8.3, 8.4, 8.5
34, 33 8.2–8.5
32, 31 8.1–8.4
30 8.1–8.3
29, 28 8.0–8.3
27, 26 8.0–8.2
25, 24 7.4, 8.0, 8.1
23, 22, 21 7.3, 7.4, 8.0
20, 19, 18 7.2–7.4
17, 16 7.1–7.3
15 7.0–7.3
14 7.0–7.2
13 5.6, 7.0–7.2
12, 11 5.6, 7.0, 7.1
10 5.4–5.6, 7.0

For example, moving a Nextcloud 32 server directly to PHP 8.5 is outside the matrix. Upgrade Nextcloud one major release at a time until the installed release supports PHP 8.5, or select an interim PHP branch that both the current and immediate target releases support.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Choose a safe upgrade path

When the target PHP is already supported

If your current Nextcloud release and the immediate target release both list the desired PHP branch, you can change PHP during the same maintenance window. Keeping one runtime across the boundary reduces the number of moving parts, but it does not remove the need for backups, app checks or sequential Nextcloud upgrades.

When the target PHP is not supported

  1. Bring the installed Nextcloud major release to its latest point release.
  2. Upgrade to the next major release only; never skip a major number.
  3. Run the scheduled background work and wait for migrations to complete.
  4. Repeat the point-release, major-release and migration cycle until the release supports your intended PHP branch.

The upgrade manual gives two or three cron.php runs as an example of the background work that should be allowed to complete. Large databases can take considerably longer, so judge completion from the job results and the Administration checks rather than from elapsed time alone.

Prepare a restorable backup and the app list

Make a fresh backup immediately before every Nextcloud upgrade and before a PHP change that will be performed separately. It must be restorable, not merely a copy whose contents have never been tested. Include all three of these items:

  • The Nextcloud database, exported with the database engine’s native backup tool.
  • The complete Nextcloud data directory, including user files and file-cache metadata.
  • config/config.php, which contains the instance settings and database connection details.

Review the critical changes for the release you are about to install. Inventory every third-party app and theme, check its compatibility with both the target Nextcloud release and PHP branch, and disable third-party apps before the change. Re-enable each one only after the core upgrade and functional checks have passed. Core apps should remain available unless the release instructions say otherwise.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
New Bee Guitar Cable 10ft Electric Instrument Bass AMP Cord
  • [Low Noise High Fidelity] New bee guitar cord with 22AWG oxygen-free-copper center conductors provides enhanced signal transfer, the PVC insulation material and the high-density stranded copper double shield provide noise rejection for quiet operation
  • [Ideal for Choice] New bee 1/4 straight and right angle metal connectors, ensures a secure connection in any instrument, pedal, or amp jack. L shape great fro on stage guitar stands
  • [Wide Compatible] Suitable for mixer, power amplifier, microphone, effector, decoder, equalizer, electoronic organ, electric guitar, electric bass and other electronic equipments. Widely used in the installation of smart home, karaoke speaker, professional stage audio, etc
  • [Easy Disassemble] Making incidental repairs quick and easy! Very nice, flexible cable
  • [Dont Hesite to Order] 24 hours customer services and professional technology team are standing by

Put an archive installation into maintenance mode

The built-in web updater enables maintenance mode automatically. A manual PHP change or archive upgrade should enable it explicitly as the HTTP user:

sudo -E -u www-data php occ maintenance:mode --on

Maintenance mode locks sessions belonging to logged-in users and prevents new logins. Keep it on while PHP is replaced and while the Nextcloud upgrade runs. Do not leave it enabled as a substitute for fixing an error.

Change PHP without mixing runtimes

Install the supported branch and extensions

Use your operating system, hosting panel or deployment tooling to install or enable a PHP branch listed for both the current release and the immediate target release. The exact package command differs between Linux distributions and is intentionally not prescribed here. Keep the extensions required by your installation, including the database driver, XML, multibyte-string, archive, GD or image-processing components and the extensions required by enabled apps.

Update the web integration

Apache may load PHP through mod_php; nginx normally passes requests to PHP-FPM. Point the web server at the new PHP-FPM pool or module, then restart the relevant service using the normal service procedure for your operating system. Do not remove the old runtime until the new one has been verified and a rollback by package selection is no longer needed.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Verify both PHP entry points

Run php -v as the account that will execute occ, and confirm the Administration overview reports the same branch. If the shell resolves a different binary, use the deployment’s configured PHP path when invoking occ; otherwise maintenance commands may run under an unsupported interpreter while web requests use another one.

Rank #4
BSIMB 15.6" Digital Family Calendar & Chore Chart, No Subscription Fees
  • Digital Family Calendar: BSIMB digital calendar wall touch screen puts an end to your chaotic life. Designed for busy families, the digital calendar keeps you organised and in step with your family. Assign different colours and tasks to each family member to make family scheduling easier and more intuitive.
  • Easy Setup and Auto-Sync: Plug in, connect to WLAN and auto-syn your electric calendar in minutes. Digital wall calendar compatible with Google calendar, iCloud calendar, Outlook calendar, Cozi calendar and Yahoo calendar. Add events directly on the device or through the ecalendar app. Electronic calendar stays current whether you're at work or traveling—no manual updates needed.
  • All-In-One Home Assistant: Smart calendar builds habits and encourage independence with personalised chores. Display daily meal plan to reduce the daily ‘What's for dinner?’ stress. To-do lists keep track of everything you want. Turning chores into valuable achievements with stars and rewards, making life easier and more enjoyable.
  • Manage Anytime Anywhere: BSIMB electronic calendar for family stay connected with the powerful ecalendar app. Access and manage your digital wall calendar anytime, anywhere with free features like stars & rewards, photo screensaver, chore charts, meals plans, to-do lists etc. Electronic planner paid features like Magic Import tailor advanced tools for users with special needs.
  • Stay in Touch with Loved Ones: Share photos or videos from your phone to electronic wall calendar with app, instantly update your life moment, and keep in touch with your family, especially those who are far away; you can also surprise your smart calendar digital wall by sending him a wish card; it's also great for keeping tech-illiterate elders in touch with the youngsters.

Run the Nextcloud upgrade

Built-in updater

For most archive-based environments, the built-in updater is the easiest route. Start it only after the backup, app review and PHP checks are complete. Follow the updater’s prompts, keep the maintenance window open, and do not refresh repeatedly when a migration is still running. If the updater reports a PHP timeout or stops before completion, use the recovery procedure below rather than starting a second web upgrade.

Manual archive replacement

Use manual replacement when your environment requires explicit control over files, services or the CLI. Perform these actions in order:

  1. Download the target Nextcloud archive outside the current installation directory and verify its integrity using the project’s published checksum or signature.
  2. Confirm that the backup is complete, then enable maintenance mode.
  3. Stop the web server and the Nextcloud cron job so no request or background task writes to the tree while files are replaced.
  4. Move the existing application code aside and extract the new release into the installation path. Preserve config/config.php and the entire data directory; do not overwrite either with files from a fresh archive.
  5. Restore the owner and permissions expected by the web user and ensure the web server can read the code while the data directory remains protected from direct web access.
  6. Restart the web server or PHP-FPM service.
  7. From inside the Nextcloud installation directory, run:

sudo -u www-data php occ upgrade

Run the command once for the release currently being installed and wait for it to finish. Re-enable the cron job after the command completes. If the release hop is part of a longer sequence, do not start the next hop until migrations and verification are complete.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Finish migrations and repair checks

After every major release, allow background jobs to run. Trigger the scheduled job manually if your deployment does not run cron promptly, using the same PHP binary and web-user account configured for the installation. Two or three cron.php runs are the manual’s example; continue until the job queue and Administration warnings settle.

If the Administration setup check requests database work, the following commands can be run from the installation directory:

  • sudo -u www-data php occ db:add-missing-columns
  • sudo -u www-data php occ db:add-missing-indices
  • sudo -u www-data php occ db:add-missing-primary-keys

Use --dry-run with these commands when you want to preview the SQL before applying it. Run only the checks requested by the installation and retain the database backup while repairs are being performed.

Verify the service before reopening it

Carry out the checks in this order while maintenance mode is still enabled, then turn it off only when the results are clean:

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  1. Confirm the displayed Nextcloud version is the intended point release.
  2. Confirm the PHP version in the Administration overview and the CLI output.
  3. Check database and storage health in the Administration area.
  4. Confirm that cron is executing and that background jobs are not accumulating errors.
  5. Open a test account session, browse folders, upload a small file and download it again.
  6. Check core apps, then re-enable third-party apps one at a time and test each app’s principal function.
  7. Review the web-server and PHP-FPM logs for fatal errors, missing extensions, permission failures and repeated application exceptions.

When the checks pass, disable maintenance mode:

sudo -E -u www-data php occ maintenance:mode --off

Test a fresh login from a private browser window and verify that normal users can access files and the applications they need.

How the installation method changes the procedure

Deployment What to change What not to do
Archive Use the archive updater or controlled file replacement, then run occ upgrade. Do not overwrite config.php or the data directory.
Snap Use the Snap channel and refresh procedure documented for that package. Do not replace host PHP packages expecting the Snap’s embedded runtime to change.
Docker Pull and deploy an image that contains a supported PHP and Nextcloud combination; preserve persistent volumes. Do not edit PHP inside a disposable container as a permanent change.
Pre-built VM Follow the appliance publisher’s upgrade and snapshot instructions. Do not apply archive paths or service names without checking the appliance layout.
Distribution package Use the package maintainer’s update path and service integration. Do not mix files from an upstream archive with package-managed files.

If the upgrade stalls or leaves maintenance mode enabled

A web upgrade can stop because a PHP timeout ends the browser request even though the server-side operation needs more time. If the page remains stuck, open a shell on the server, keep a backup of the current state, and follow this recovery sequence:

  1. Check whether the upgrade process is still running before launching another one.
  2. If it has stopped, turn maintenance mode off only when you are ready to run the command-line recovery, using sudo -E -u www-data php occ maintenance:mode --off.
  3. From the installation directory, run sudo -u www-data php occ upgrade manually and capture its complete output.
  4. If the command reports that a repair is required, run sudo -u www-data php occ maintenance:repair, then retry the upgrade once.
  5. Repeat the migration and verification checks before allowing users back in.

If the command-line upgrade reports a schema or file error, stop and preserve the logs and database state. Continuing to replace files blindly can make recovery harder.

Never downgrade the existing installation

Nextcloud states that downgrading is unsupported and risks corrupting data. Do not install an older code archive over a database that has already been upgraded, and do not attempt to reverse migrations by hand.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

For a failed upgrade that cannot be repaired, build a fresh installation at the desired supported version and restore the database, data directory and configuration from a known-good backup. Verify the restored copy in an isolated maintenance window before directing users to it.

Compare the available upgrade approaches

Decision factor Built-in updater Manual archive upgrade
Control Guided workflow with fewer file operations. Explicit control over archives, services, permissions and CLI output.
Best fit Most conventional archive installations. Environments with change-control requirements or custom deployment tooling.
Downtime Maintenance mode for the duration of code and migration work. Maintenance mode, plus any time needed to stop services and replace files.
Rollback posture Restore from a tested backup; do not downgrade in place. Restore from a tested backup; do not downgrade in place.
App risk Still requires disabling and compatibility-checking third-party apps. Still requires disabling and compatibility-checking third-party apps.
PHP requirement Web and CLI PHP must both be supported by the current and target releases. Web and CLI PHP must both be supported by the current and target releases.

When paid support is worth considering

For an organisation-critical deployment, Nextcloud’s premium or enterprise support is an option when you need a defined support commitment rather than a self-managed upgrade. The current requirements documentation describes five years of long-term support covering high and critical security issues, data-loss fixes and regressions. Availability and terms vary by geography and offer, so confirm the current package directly with Nextcloud before purchase.

Final pre-flight checklist

  • Exact Nextcloud release and installation method recorded.
  • Target PHP branch listed for both the current and immediate target release.
  • Database, data directory and config/config.php backed up and restorable.
  • Third-party apps checked and disabled.
  • Maintenance mode enabled for the change window.
  • Web-server PHP and CLI PHP confirmed to be the intended supported branch.
  • Nextcloud upgraded one major release at a time.
  • Background migrations and cron jobs completed after each hop.
  • Version, logins, files, storage, database, cron and apps verified before maintenance mode is disabled.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
Outdated Drivers Are Slowing You DownFree scan - exact matches
Windows Errors? Fix Them Before They SpreadFree repair scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.