.. _clear-samba-share-to-Windows:

Samba\* as a host
#################

This tutorial describes how to enable simple file sharing from a system
running |CL-ATTR| to a Windows\* computer using Samba. For more advanced
sharing, refer to the `Samba guide`_.

.. contents::
   :local:
   :depth: 1

Prerequisites
*************

*	|CL| is installed on your host system.

	For detailed instructions, follow the steps in
	:ref:`bare-metal-install-desktop`.

*	Before you install any new packages, update |CL| with the following
	command:

	.. code-block:: bash

	   sudo swupd update


Set up file sharing
*******************

#.	Log in and get root privileges.

	.. code-block:: bash

		sudo -s

#.	Add the :command:`storage-utils` bundle, which includes the Samba binaries.

	.. code-block:: bash

		swupd bundle-add storage-utils

	.. note::

		The :command:`os-clr-on-clr` bundle also includes the Samba binaries.

#.	Create a configuration file named :file:`/etc/samba/smb.conf`. In this
	example, :envvar:`[Downloads]` enables a folder share with a specific user.
	:envvar:`[Documents]` enables a folder share with any user. The example
	assumes that the user account :envvar:`clearlinuxuser` already exists.

	If :envvar:`valid users` is not specified, then anyone with a user account
	on the machine and with their Samba password already set can access the
	folder. However, the account is only able to access files and folders for
	which they have appropriate permissions.

	Use either :command:`chown` to change the owner of the file or use
	:command:`chmod` to change the permissions to allow other users to access
	the file.

	.. code-block:: console

		[Global]
		map to guest = bad user

		[Downloads]
		path=/home/clearlinuxuser/Downloads
		read only = no
		guest ok = no
		valid users = clearlinuxuser

		[Documents]
		path=/home/clearlinuxuser/Documents
		read only = no
		browsable = yes
		guest ok = yes

#.	Enable the Samba daemon to start every time.

	.. code-block:: bash

		systemctl enable smb
		systemctl start smb

#.	Use :command:`smbpasswd` to add the initial password for the user
	account to access the share. Be aware that Samba maintains its own list of
	passwords for user accounts. The Samba password list can be different from
	the password used to log in.

	.. code-block:: bash

		smbpasswd -a clearlinuxuser

The setup is now complete and a Windows machine on the same network can access
the shares. Windows uses the format
:file:`\\\\[server IP or hostname]\\folder` to access shares. Access the shares
directly with Windows Explorer or by mapping a network drive.

Use the IP address of the |CL| machine for an easy access method. If the
|CL| machine is behind an Active Directory domain controller or a DNS server,
use the hostname of the |CL| machine. For other ways to access shares using a
hostname instead of an IP address, see `Chapter 7 of the Samba guide`_.


Map |CL| drive in Windows
*************************

#.	Open Windows Explorer and click on the left sidebar on :guilabel:`This PC`
	to change the options available at the top.

#.	Click the :guilabel:`Map Network Drive` icon and enter the path in the
	format: :file:`\\\\[server IP or hostname]\\[shared folder]`

#.	Check the box :guilabel:`Connect using different credentials`. Enter
	the Samba user `clearlinuxuser` and the password created with
	:command:`smbpasswd`. See Figure 1 for details.

	.. figure:: /_figures/samba/smb-1.png
		:scale: 70%
		:alt: Map a network drive in Windows Explorer

		Figure 1: Map a network drive in Windows Explorer.

When complete, Windows Explorer displays the share drive as shown in Figure 2.

.. figure:: /_figures/samba/smb-2.png
	:scale: 70%
	:alt: View a share drive in Windows Explorer

	Figure 2: View a share drive in Windows Explorer.





.. _Samba guide: https://www.samba.org/samba/docs/using_samba/ch00.html
.. _Chapter 7 of the Samba guide: https://www.samba.org/samba/docs/using_samba/ch07.html