Skip to content

Commit d9636b9

Browse files
skjnldsvbackportbot[bot]
authored andcommitted
docs(admin): clarify web server user and ownership requirements
The chown -R www-data:www-data command implied that ownership must be www-data:www-data specifically. The actual requirement is that the web server process user has read/write access to the Nextcloud directories. Added a note clarifying: - www-data is the Debian/Ubuntu default; RHEL/CentOS/Fedora uses apache - Ownership is not strictly required — group membership + group-writable permissions are sufficient in environments where chown is not possible (shared hosting, Docker bind-mounts, VirtualBox shared folders, etc.) Fixes #1239 Signed-off-by: skjnldsv <skjnldsv@protonmail.com>
1 parent 05a4532 commit d9636b9

1 file changed

Lines changed: 10 additions & 0 deletions

File tree

admin_manual/installation/source_installation.rst

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -218,6 +218,16 @@ your HTTP user::
218218

219219
chown -R www-data:www-data /var/www/nextcloud/
220220

221+
.. note:: ``www-data`` is the default web server user on Debian/Ubuntu systems.
222+
On RHEL/CentOS/Fedora use ``apache``. The key requirement is that the web
223+
server process user has **read and write access** to all Nextcloud directories
224+
— ownership is not strictly necessary. In environments where changing ownership
225+
is not possible (shared hosting, Docker bind-mounts, etc.), it is sufficient to
226+
add the web server user to the group that owns the directories and ensure the
227+
directories are group-writable, for example::
228+
229+
usermod -a -G vboxsf www-data
230+
221231
.. note:: Admins of SELinux-enabled distributions may need to write new SELinux
222232
rules to complete their Nextcloud installation; see
223233
:ref:`selinux_tips_label`.

0 commit comments

Comments
 (0)