From 13df6df0429195e6f8b5de8c7d322b750ec19232 Mon Sep 17 00:00:00 2001 From: Morris Jobke Date: Wed, 7 Jun 2017 22:30:31 -0500 Subject: [PATCH] Update skeleton dir guide Signed-off-by: Morris Jobke --- .../default_files_configuration.rst | 34 +++++++++---------- 1 file changed, 17 insertions(+), 17 deletions(-) diff --git a/admin_manual/configuration_files/default_files_configuration.rst b/admin_manual/configuration_files/default_files_configuration.rst index 372e6aec3..95cba178e 100644 --- a/admin_manual/configuration_files/default_files_configuration.rst +++ b/admin_manual/configuration_files/default_files_configuration.rst @@ -2,15 +2,21 @@ Providing Default Files ======================= -You may distribute a set of default files and folders to all users by placing -them in the :file:`nextcloud/core/skeleton` directory on your Nextcloud server. -These files appear only to new users after their initial login, and existing -users will not see files that are added to this directory after their first -login. The files in the :file:`skeleton` directory are copied into the users' -data directories, so they may change and delete the files without affecting the -originals. +You may distribute a set of default files and folders to all users by placing +them in directory that is readable by the webserver user. This allows you to +overwrite the files that are shipped by default with Nextcloud in +``core/skeleton``. That custom directory should then be configured in the +``config.php`` via the configuration option ``skeletondirectory`` (see +:doc:`../configuration_server/config_sample_php_parameters`). Leave +empty to not copy any skeleton files. -This screenshot shows a set of photos in the :file:`skeleton` directory. +These files will be copied only to new users after their initial login, and +existing users will not see files that are added to this directory after their +first login. The files in the ``skeleton`` directory are copied into the +users data directories, so they may change and delete the files without +affecting the originals. + +This screenshot shows a set of photos in the ``skeleton`` directory. .. image:: ../images/skeleton-files.png @@ -18,12 +24,6 @@ They appear on the user's Nextcloud Files page just like any other files. .. image:: ../images/skeleton-files1.png -Additional Configuration ------------------------- - -The configuration option ``skeletondirectory`` available in your -``config.php`` (See -:doc:`../configuration_server/config_sample_php_parameters`) allows -you to configure the directory where the skeleton files are located. -These files will be copied to the data directory of new users. Leave -empty to not copy any skeleton files. \ No newline at end of file +.. note:: Overwriting the files in ``core/skeleton`` is not recommended, + because those changes will be overwritten on the next update of the Nextcloud + server. \ No newline at end of file