mirror of
https://github.com/nextcloud/documentation.git
synced 2026-01-03 02:09:45 +07:00
dfe18632d7
10.14 and 10.15 are tested by doing major by major migrations. Co-authored-by: Ferdinand Thiessen <opensource@fthiessen.de> Co-authored-by: rakekniven <2069590+rakekniven@users.noreply.github.com> Signed-off-by: Ferdinand Thiessen <opensource@fthiessen.de>
62 lines
3.2 KiB
ReStructuredText
62 lines
3.2 KiB
ReStructuredText
=======================
|
|
Migrating from ownCloud
|
|
=======================
|
|
|
|
|
|
.. note:: Especially when migrating from ownCloud to Nextcloud you should
|
|
create a backup of the config, database and the data directory,
|
|
in case something goes wrong.
|
|
|
|
Currently migrating from ownCloud is like performing a manual update.
|
|
So it is quite easy, to migrate from one ownCloud version to at least one Nextcloud version.
|
|
However this does only work with versions that are close enough database and code-wise.
|
|
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 |
|
|
+-------------------+-------------------------------+
|
|
|
|
.. 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
|
|
`<https://www.php.net/supported-versions.php>`_.
|
|
|
|
1. First download the correct version of Nextcloud from our `older 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.
|
|
|
|
4. When migrating to Nextcloud 20.0 or later, you will also need to 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``.
|
|
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.
|
|
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.
|
|
|
|
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
|
|
|