Skip to content

docs(admin): ownCloud migration version.php and background migrations - #15721

Open
whoalin1 wants to merge 1 commit into
nextcloud:masterfrom
whoalin1:docs/owncloud-migration-version-php-background
Open

whoalin1 wants to merge 1 commit into
nextcloud:masterfrom
whoalin1:docs/owncloud-migration-version-php-background

Conversation

@whoalin1

@whoalin1 whoalin1 commented Oct 7, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Closes #13109

The ownCloud → Nextcloud migration page was missing two practical hints from real migrations:

  1. When version.php only lists a slightly older ownCloud release than the one you are migrating from, temporarily extending $OC_VersionCanBeUpgradedFrom['ownCloud'] (then reverting) may be required.
  2. After each major upgrade step, wait for background migrations to finish before starting the next major (link to Approaching Upgrades).

Test plan

  • Render admin_manual/maintenance/migrating_owncloud.rst / docs build
  • Confirm wording matches current version.php / upgrade guidance

AI disclosure

This PR was drafted with the help of AI coding assistants (Cursor agents / LLM-based tools), including the description. I am responsible for it and happy to rework anything that doesn't fit.

All commits carry an Assisted-by: Cursor:grok-4.7 trailer.

Add hints for temporarily extending $OC_VersionCanBeUpgradedFrom when version.php is slightly older, and for waiting for background migrations after each major step.

Closes nextcloud#13109

Assisted-by: Cursor:grok-4.7
Signed-off-by: whoalin1 <whoalin414@gmail.com>
@whoalin1
whoalin1 force-pushed the docs/owncloud-migration-version-php-background branch from b92a6be to d2a9696 Compare October 9, 2026 14:11
@github-actions

Copy link
Copy Markdown
Contributor

Hello there,
Thank you so much for taking the time and effort to create a pull request to our Nextcloud project.

We hope that the review process is going smooth and is helpful for you. We want to ensure your pull request is reviewed to your satisfaction. If you have a moment, our community management team would very much appreciate your feedback on your experience with this PR review process.

Your feedback is valuable to us as we continuously strive to improve our community developer experience. Please take a moment to complete our short survey by clicking on the following link: https://cloud.nextcloud.com/apps/forms/s/i9Ago4EQRZ7TWxjfmeEpPkf6

Thank you for contributing to Nextcloud and we hope to hear from you soon!

(If you believe you should not receive this message, you can add yourself to the blocklist.)

@skjnldsv skjnldsv left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Master's version.php already lists 10.13 to 10.16, which matches the table, so this doesn't seem needed anymore. The key is lowercase 'owncloud', and editing core files breaks the integrity check. Background migrations are already covered in upgrade.rst, a link there would be enough.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Owncloud migration documentation: Add hints to edit version.php, and to trigger background migrations after each upgrade step

2 participants