From 770e180bbf99a098f6f19b340a8b731936faed25 Mon Sep 17 00:00:00 2001 From: Marco van Zwetselaar Date: Tue, 9 Jun 2020 01:45:10 +0300 Subject: [PATCH] Document the need to symlink apps outside server root Document that any apps path outside the server root must be symlinked from inside the server root. Resolves issue https://github.com/nextcloud/server/issues/21292. --- admin_manual/apps_management.rst | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/admin_manual/apps_management.rst b/admin_manual/apps_management.rst index 30116f4f9..8fbb03426 100644 --- a/admin_manual/apps_management.rst +++ b/admin_manual/apps_management.rst @@ -89,6 +89,13 @@ in that folder. ], ], +.. note:: Apps paths can be located outside the server root. However, for any + **path** outside the server root, you need to create a symlink in the server + root that points **url** to **path**. + For instance, if **path** is ``/var/local/lib/nextcloud/apps``, and **url** + is ``/apps2``, then you would do this in the server root: + ``ln -sf /var/local/lib/nextcloud/apps ./apps2`` + Using a self hosted apps store ------------------------------ @@ -112,4 +119,4 @@ To enable a self hosted apps store: By default the apps store is enabled and configured to use ``https://apps.nextcloud.com/api/v1`` as apps store url. Nextcloud will fetch ``apps.json`` and ``categories.json`` from there. To use the defaults again remove **appstoreenabled** and **appstoreurl** from the configuration. -Example: If ``categories.json`` is available at ``https://apps.nextcloud.com/api/v1/categories.json`` the apps store url is ``https://apps.nextcloud.com/api/v1``. \ No newline at end of file +Example: If ``categories.json`` is available at ``https://apps.nextcloud.com/api/v1/categories.json`` the apps store url is ``https://apps.nextcloud.com/api/v1``.