centersl/nextcloud-docs
1
0
Fork 0
mirror of https://github.com/nextcloud/documentation.git synced 2026-03-27 13:38:39 +07:00
Code Issues Packages Projects Releases Wiki Activity

feat(applying-patch): improve some details

Browse Source 
Signed-off-by: Simon L. <szaimen@e.mail.de>
This commit is contained in:
Simon L.
2025-12-09 21:06:51 +01:00
parent a119976e1f
commit f5761c94d7
1 changed files with 15 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files

27
admin_manual/issues/applying_patch.rst
View File

@@ -8,14 +8,15 @@ Obtaining a patch
If you found a related pull request on GitHub that solves your issue, or you want to help developers and verify a fix works, you can get a patch for the pull request. If you found a related pull request on GitHub that solves your issue, or you want to help developers and verify a fix works, you can get a patch for the pull request.
1. Using https://github.com/nextcloud/server/pull/26396 as an example. 1. Using https://github.com/nextcloud/server/pull/26396 as an example.
2. Append ``.patch`` to the URL: https://github.com/nextcloud/server/pull/26396.patch 2. Append ``.diff`` to the URL: https://github.com/nextcloud/server/pull/26396.diff
3. Download the patch to your server and follow the `Applying a patch`_ steps. 3. Download the patch to your server e.g. via ``wget https://github.com/nextcloud/server/pull/26396.diff`` (this will place ``26396.diff`` in the local directory)
4. If you are on an older Nextcloud version, you might first need to go to the correct backported patch for your version. 4. Follow the `Applying a patch`_ steps.
5. If you are on an older Nextcloud version, you might first need to go to the correct backported patch for your version.
.. image:: images/getting-a-patch-from-github.png .. image:: images/getting-a-patch-from-github.png
:alt: backportbot-nextcloud linking to the pull request for an older version. :alt: backportbot-nextcloud linking to the pull request for an older version.
5. You can find the appropriate version by looking for a link posted by ``backportbot-nextcloud`` to the backport pull request for your release, or by checking for a developer comment with a manual backport link. Use the ``.patch`` URL of that backport PR. 6. You can find the appropriate version by looking for a link posted by ``backportbot-nextcloud`` to the backport pull request for your release, or by checking for a developer comment with a manual backport link. Use the ``.diff`` URL of that backport PR.
Applying a patch Applying a patch
---------------- ----------------
@@ -24,20 +25,22 @@ Patching server
^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^
1. Navigate to your Nextcloud server's root directory (the one that contains the ``status.php`` file). 1. Navigate to your Nextcloud server's root directory (the one that contains the ``status.php`` file).
2. Apply the patch with the following command:: 2. Download the patch to your server e.g. via ``wget https://github.com/nextcloud/server/pull/26396.diff`` (this will place ``26396.diff`` in the local directory)
3. Apply the patch with the following command::
patch -p 1 < /path/to/the/file.patch patch -p 1 < ./26396.diff
3. Alternatively, if the patch command is not available, use:: 4. Alternatively, if the patch command is not available, use::
git apply --check /path/to/the/file.diff git apply --check ./26396.diff
git apply /path/to/the/file.diff git apply ./26396.diff
Patching apps Patching apps
^^^^^^^^^^^^^ ^^^^^^^^^^^^^
1. Navigate to the root of the app (usually ``apps/[APPID]/``). If you cannot find the app there, use the ``sudo -E -u www-data php occ app:getpath APPID`` command to find the path. 1. Navigate to the root of the app (usually ``apps/[APPID]/``). If you cannot find the app there, use the ``sudo -E -u www-data php occ app:getpath APPID`` command to find the path.
2. Apply the patch with the same command as in `Patching server`_. 2. Download the patch to your server e.g. via ``wget https://github.com/nextcloud/<app>/pull/26396.diff`` (this will place ``26396.diff`` in the local directory)
3. Apply the patch with the same command as in `Patching server`_.
Reverting a patch Reverting a patch
----------------- -----------------
@@ -45,11 +48,11 @@ Reverting a patch
1. Navigate to the directory where you applied the patch. 1. Navigate to the directory where you applied the patch.
2. Revert the patch with the ``-R`` option:: 2. Revert the patch with the ``-R`` option::
patch -R -p 1 < /path/to/the/file.patch patch -R -p 1 < ./26396.diff
3. Alternatively, if the patch command is not available, use:: 3. Alternatively, if the patch command is not available, use::
git apply --reverse /path/to/the/file.diff git apply --reverse ./26396.diff
Notes and troubleshooting Notes and troubleshooting
------------------------- -------------------------