diff --git a/admin_manual/configuration_server/email_configuration.rst b/admin_manual/configuration_server/email_configuration.rst index 16dc789de8f..ed68a54b58e 100644 --- a/admin_manual/configuration_server/email_configuration.rst +++ b/admin_manual/configuration_server/email_configuration.rst @@ -1,3 +1,5 @@ +.. _email-config: + ===== Email ===== @@ -29,6 +31,8 @@ Sendmail when your mail server is on the same machine as Nextcloud. drop-in Sendmail replacement such as Postfix, Exim, or Courier. All of these include a ``sendmail`` binary, and are freely-interchangeable. +.. _email-smtp-config: + Configuring an SMTP server -------------------------- diff --git a/admin_manual/contents.rst b/admin_manual/contents.rst index e0789991afd..9a580bafc66 100644 --- a/admin_manual/contents.rst +++ b/admin_manual/contents.rst @@ -6,7 +6,7 @@ Table of contents :maxdepth: 2 index - release_notes + release_notes/index release_schedule installation/index configuration_server/index diff --git a/admin_manual/installation/nginx.rst b/admin_manual/installation/nginx.rst index f86a4c17118..62b10075425 100644 --- a/admin_manual/installation/nginx.rst +++ b/admin_manual/installation/nginx.rst @@ -1,3 +1,5 @@ +.. _nginx-config: + =================== NGINX configuration =================== diff --git a/admin_manual/maintenance/manual_upgrade.rst b/admin_manual/maintenance/manual_upgrade.rst index 985db124fe7..0cb8ca8003e 100644 --- a/admin_manual/maintenance/manual_upgrade.rst +++ b/admin_manual/maintenance/manual_upgrade.rst @@ -2,6 +2,10 @@ Upgrade manually ================ +.. seealso:: + + If you upgrade from a previous major version please see :ref:`critical changes` first. + Always start by making a fresh backup and disabling all 3rd party apps. 1. Back up your existing Nextcloud Server database, data directory, and diff --git a/admin_manual/maintenance/package_upgrade.rst b/admin_manual/maintenance/package_upgrade.rst index ea4a5afef10..77232651271 100644 --- a/admin_manual/maintenance/package_upgrade.rst +++ b/admin_manual/maintenance/package_upgrade.rst @@ -58,6 +58,10 @@ using Snappy Base 16.04 as it's currently unreleased. Upgrade tips ------------ +.. seealso:: + + If you upgrade from a previous major version please see :ref:`critical changes` first. + Upgrading Nextcloud from a Snap is just like upgrading any snap package. For example: @@ -86,6 +90,10 @@ This example is for CentOS/RHEL/Fedora:: Upgrading across skipped releases --------------------------------- +.. seealso:: + + If you upgrade from a previous major version please see :ref:`critical changes` first. + It is best to update your Nextcloud installation with every new point release, and to never skip any major releases. While this requirement is being worked on, for the moment If you have skipped any major releases you can bring your diff --git a/admin_manual/maintenance/upgrade.rst b/admin_manual/maintenance/upgrade.rst index d7abb79b343..aa209a93375 100644 --- a/admin_manual/maintenance/upgrade.rst +++ b/admin_manual/maintenance/upgrade.rst @@ -66,6 +66,10 @@ based updater but on the command line. Prerequisites ------------- +.. seealso:: + + If you upgrade from a previous major version please see :ref:`critical changes` first. + You should always maintain :doc:`regular backups ` and make a fresh backup before every upgrade. diff --git a/admin_manual/release_notes.rst b/admin_manual/release_notes.rst index e2efc64287d..affd3b022fd 100644 --- a/admin_manual/release_notes.rst +++ b/admin_manual/release_notes.rst @@ -2,4 +2,4 @@ Release notes ============= -See `the official changelog `_ for release notes. +The release notes have been split into :ref:`subpages per Nextcloud release`. diff --git a/admin_manual/release_notes/index.rst b/admin_manual/release_notes/index.rst new file mode 100644 index 00000000000..df572d4c84e --- /dev/null +++ b/admin_manual/release_notes/index.rst @@ -0,0 +1,22 @@ +============= +Release notes +============= + +.. _critical-changes: + +Critical changes +---------------- + +Once you've installed and configured your server, you will want to keep it up to date with the latest Nextcloud features. + +These sub pages will cover the most important changes in Nextcloud, as well as some guides on how to upgrade existing installations. + +.. toctree:: + :maxdepth: 1 + + upgrade_to_26.rst + +Changelog +--------- + +See `the official changelog `_ for a complete list of changes. diff --git a/admin_manual/release_notes/upgrade_to_26.rst b/admin_manual/release_notes/upgrade_to_26.rst new file mode 100644 index 00000000000..009a8b2d89a --- /dev/null +++ b/admin_manual/release_notes/upgrade_to_26.rst @@ -0,0 +1,19 @@ +======================= +Upgrade to Nextcloud 26 +======================= + +System requirements +------------------- + +* PHP 8.2 is now supported, but 8.1 is recommended. +* PHP7.4 is no longer supported. + +System email +------------ + +The software component to send system emails (notifications, invites, password reset, etc) had to be replaced. The new library should work without any changes out of the box for most setups. Only NTLM/Exchange is kown to be no longer supported. See :ref:`email-smtp-config`. + +Web server configuration +------------------------ + +* The recommended :ref:`nginx configuration` changed. diff --git a/admin_manual/release_schedule.rst b/admin_manual/release_schedule.rst index 83f11c79c6c..6fb44697ea0 100644 --- a/admin_manual/release_schedule.rst +++ b/admin_manual/release_schedule.rst @@ -15,18 +15,3 @@ Maintenance releases -------------------- Maintenance releases are scheduled in a 4 week cycle with one week before the release date having the freeze and RC 1. - -Critical changes ----------------- - -* PHP 7.4 is not supported anymore. Please upgrade to PHP 8.0 or higher. -* PHP 8.2 is now supported. -* The recommended webserver configuration has changed to no longer include a default redirect to the login page - * For Apache this change will automatically come with the ``.htaccess`` file provided by the release - * for nginx administrators should ensure that their config is up to date with the `documentation `_ - * The relevant lines to remove are ``error_page 403 /core/templates/403.php;`` and ``error_page 404 /core/templates/404.php;`` - -You can find important documentation for app developers here: https://docs.nextcloud.com/server/latest/developer_manual/app_publishing_maintenance/app_upgrade_guide/index.html -Each document lists a link to the breaking changes of the corresponding release. - -.. TODO ON RELEASE: Update version number above on release