fix(occ): clarify occ upgrade only runs migrations, not code replacement#14848
Merged
Conversation
Add important notice to the "Command line upgrade" section explaining that occ upgrade handles database migrations and app upgrades only — it does not download or replace code files. Users must run updater.phar or extract a tarball first. Also explains the "Nextcloud is up to date" false negative that occurs when occ upgrade is run before code files have been replaced. Fixes #8837 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> Signed-off-by: John Molakvoæ (skjnldsv) <skjnldsv@protonmail.com>
Contributor
📖 Documentation Preview📄 1 changed documentation pageLast updated: Thu, 14 May 2026 08:06:37 GMT |
AndyScherzinger
approved these changes
May 14, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
☑️ Resolves
Summary
The
occ upgrade"Command line upgrade" section was misleading: users would runocc upgradebefore updating code files and get "Nextcloud is up to date" — technically correct but confusing since the code update hadn't happened yet.Added an
.. important::block that:occ upgradehandles DB migrations and app upgrades only — it does not download or replace code filesupdater.pharor extract a tarball first)🖼️ Screenshots
✅ Checklist
codespellor similar and addressed any spelling issues