mirror of
https://github.com/nextcloud/documentation.git
synced 2026-01-04 10:46:21 +07:00
7b27cf8dcd
* Changes for Nextcloud * Changes for Nextcloud * Update command_line_installation.rst -oci Enterprise removed * removed Enterprise * Changing to nextcloud * enterprise removed * Update external_storage_configuration_gui.rst typo * Update command_line_installation.rst Oracle changed * to nextcloud * Update linux_installation.rst * Update linux_installation.rst
48 lines
1.9 KiB
ReStructuredText
48 lines
1.9 KiB
ReStructuredText
========
|
|
SMB/CIFS
|
|
========
|
|
|
|
Nextcloud can connect to Windows file servers or other SMB-compatible servers
|
|
with the SMB/CIFS backend.
|
|
|
|
.. note:: The SMB/CIFS backend requires ``smbclient`` or
|
|
the PHP smbclient module to be installed on the Nextcloud server. The PHP
|
|
smbclient module is preferred, but either will work. These
|
|
should be included in any Linux distribution. (See `PECL smbclient
|
|
<https://pecl.php.net/package/smbclient>`_ if your distro does not include
|
|
them.)
|
|
|
|
You need the following information:
|
|
|
|
* Folder name for your local mountpoint.
|
|
* Host: The URL of the Samba server.
|
|
* Username: The username or domain/username used to login to the Samba
|
|
server.
|
|
* Password: the password to login to the Samba server.
|
|
* Share: The share on the Samba server to mount.
|
|
* Remote Subfolder: The remote subfolder inside the Samba share to mount
|
|
(optional, defaults to /). To assign the Nextcloud logon username
|
|
automatically to the subfolder, use ``$user`` instead of a particular
|
|
subfolder name.
|
|
* And finally, the Nextcloud users and groups who get access to the share.
|
|
|
|
Optionally, you can specify a ``Domain``. This is useful in
|
|
cases where the
|
|
SMB server requires a domain and a username, and an advanced authentication
|
|
mechanism like session credentials is used so that the username cannot be
|
|
modified. This is concatenated with the username, so the backend gets
|
|
``domain\username``
|
|
|
|
.. note:: For improved reliability and performance, we recommended installing
|
|
``libsmbclient-php``, a native PHP module for connecting to
|
|
SMB servers.
|
|
|
|
.. figure:: images/smb.png
|
|
:alt: Samba external storage configuration.
|
|
:scale: 75%
|
|
|
|
See :doc:`../external_storage_configuration_gui` for additional mount
|
|
options and information.
|
|
|
|
See :doc:`auth_mechanisms` for more information on authentication schemes.
|