Skip to content

chore(admin): update ownCloud migration guide #15048

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
MichaIng wants to merge 1 commit into
base: master
Choose a base branch
from
Open

chore(admin): update ownCloud migration guide #15048

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 16 additions & 20 deletions admin_manual/maintenance/migrating_owncloud.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,48 +15,44 @@ See the table below for a version map, where migrating is easily possible:
+-------------------+-------------------------------+
| ownCloud | Nextcloud |
+===================+===============================+
| 10.13.x | 25.0.13 |
| 10.14.x | 25.0.13 |
| 10.15.x | 25.0.13 |
| 10.16.x | 25.0.13 |
| 10.13.x | 34.0.0 |
| 10.14.x | 34.0.0 |
| 10.15.x | 34.0.0 |
| 10.16.x | 34.0.0 |
+-------------------+-------------------------------+

.. note:: Since ownCloud does not and will not support PHP 8.0 or higher, you
need to migrate from ownCloud 10.13.x to Nextcloud 25 and then
further upgrade from there. We urge you to migrate to Nextcloud
since PHP versions prior PHP 8 are end of life, see
need to upgrade your PHP instance first, after which, ownCloud won't
be accessible anymore. See :doc:`../installation/system_requirements`
about PHP versions supported by Nextcloud. We urge you to migrate to
Nextcloud since PHP versions prior PHP 8 are end of life, see
`<https://www.php.net/supported-versions.php>`_.

1. First download the correct version of Nextcloud from our `older releases page <https://nextcloud.com/changelog/>`_,
1. First download the correct version of Nextcloud from our `releases page <https://nextcloud.com/changelog/>`_,

2. Make sure to have do a :doc:`backup<backup>` before migrating.

3. Follow the upgrade instructions described in the :doc:`manual_upgrade` manual.
3. Upgrade PHP to a version supported by the downloaded Nextcloud version.

4. When migrating to Nextcloud 20.0 or later, you will also need to run the following commands after ``occ upgrade``:
4. Follow the upgrade instructions described in the :doc:`manual_upgrade` manual.

5. Run the following commands after ``occ upgrade``:

* ``occ db:convert-filecache-bigint``
* ``occ db:add-missing-columns``
* ``occ db:add-missing-indices``
* ``occ db:add-missing-primary-keys``

5. If system cron was used, please verify if crontab entry was using the command ``occ system:cron``.
6. If system cron was used, please verify if crontab entry was using the command ``occ system:cron``.
If yes, please adjust it to use the ``php`` command instead according to :ref:`the background jobs configuration documentation<system-cron-configuration-label>`

6. As Nextcloud 25 is the last Nextcloud version supporting PHP 7 you need to upgrade your PHP installation afterwards to continue updating to current Nextcloud release.
We recommend to update PHP to version 8.1 before continuing with the updates.

7. Use the :doc:`Nextcloud built-in updater<update>` to update your instance to the newest version.
7. In case, use the :doc:`Nextcloud built-in updater<update>` to update your instance to the newest version.
This must be done for every major version, since updates between multiple major versions are not supported.
So the update path would be: 26 → 27.1 → 28 → 29 → 30 → 31.

8. When reaching Nextcloud 30 or 31 we recommend to update PHP again to a current version like PHP 8.3.
You can do so also in between, as PHP 8.2 is already supported since Nextcloud 26 and PHP 8.3 since Nextcloud 28,
but in most cases it is easier to first complete the Nextcloud version updates.
8. If multiple major version upgrades are done, it might be needed to upgrade PHP again in between.

9. Make sure to also verify the "Security & setup warnings" in the "Overview" section on the settings page.

10. In some cases, apps installed from the ownCloud Market might have been disabled as incompatible
(ex: calendar and contacts), so you should reinstall the Nextcloud ones using
``occ app:enable calendar``, ``occ app:enable contacts``, etc

Loading