Skip to content

Commit a031150

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 6dee9c5 commit a031150

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
@@ -237,6 +237,16 @@ your HTTP user::
237237

238238
chown -R www-data:www-data /var/www/nextcloud/
239239

240+
.. note:: ``www-data`` is the default web server user on Debian/Ubuntu systems.
241+
On RHEL/CentOS/Fedora use ``apache``. The key requirement is that the web
242+
server process user has **read and write access** to all Nextcloud directories
243+
— ownership is not strictly necessary. In environments where changing ownership
244+
is not possible (shared hosting, Docker bind-mounts, etc.), it is sufficient to
245+
add the web server user to the group that owns the directories and ensure the
246+
directories are group-writable, for example::
247+
248+
usermod -a -G vboxsf www-data
249+
240250
.. note:: Admins of SELinux-enabled distributions may need to write new SELinux
241251
rules to complete their Nextcloud installation; see
242252
:ref:`selinux_tips_label`.

0 commit comments

Comments
 (0)