Skip to content

Commit 616504d

Browse files
committed
Strengthen smb backend's PHP smbclient recommendation (#9428)
Updates the prerequisite note in admin_manual/.../smb.rst to: - name the actual package (php-smbclient / libsmbclient-php) so admins know what to apt/yum install; - explain *why* the PHP module is preferred (without it the backend falls back to the smbclient binary, which can fail to download files larger than ~512 MB from external SMB shares — the bug reported in nextcloud/server#31308); - link to that upstream issue so admins hitting the failure mode can find this advice from the issue tracker.
1 parent 32eaade commit 616504d

1 file changed

Lines changed: 8 additions & 3 deletions

File tree

  • admin_manual/configuration_files/external_storage

admin_manual/configuration_files/external_storage/smb.rst

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,14 @@ Nextcloud can connect to Windows file servers or other SMB-compatible servers
66
with the SMB/CIFS backend.
77

88
.. note:: The SMB/CIFS backend requires ``smbclient`` or
9-
the PHP smbclient module to be installed on the Nextcloud server. The PHP
10-
smbclient module is preferred, but either will work. These
11-
should be included in any Linux distribution. (See `PECL smbclient
9+
the PHP smbclient module (``php-smbclient`` / ``libsmbclient-php``) to be
10+
installed on the Nextcloud server. The PHP smbclient module is **strongly
11+
preferred** — without it, the backend falls back to spawning the
12+
``smbclient`` binary, which has known limitations (notably, downloads of
13+
files larger than ~512 MB from external SMB shares can fail; see
14+
`nextcloud/server#31308
15+
<https://github.com/nextcloud/server/issues/31308>`_). These should be
16+
included in any Linux distribution. (See `PECL smbclient
1217
<https://pecl.php.net/package/smbclient>`_ if your distro does not include
1318
them.)
1419

0 commit comments

Comments
 (0)