Skip to content

Update samba.md #1739

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Jun 8, 2021
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 21 additions & 0 deletions remote-access/samba.md
Original file line number Diff line number Diff line change
Expand Up @@ -73,6 +73,26 @@ cd windowshare
ls
```

### "Host is down" error

This error is caused by a combination of two things: A SMB protocol version mismatch, and the CIFS client on Linux returning a misleading error message. In order to fix this a version entry needs to be added to the mount command. By default Raspberry Pi OS will only use versions 2.1 and above, which are compatible with Windows 7 and later. Older devices, including some NAS, may require version 1.0:

```
sudo mount.cifs //IP/share /mnt/point -o user=<uname>,vers=1.0
```

You may need to try different versions to match up with the server version. Possible values are:

| Version | Description |
|---------|-------------|
| 1.0 | Classic CIFS/SMBv1 protocol |
| 2.0 | The SMBv2.002 protocol. Windows Vista Service Pack 1, and Windows Server 2008 |
| 2.1 | The SMBv2.1 protocol. Microsoft Windows 7 and Windows Server 2008R2 |
| 3.0 | The SMBv3.0 protocol. Microsoft Windows 8 and Windows Server 2012 |
| 3.02 | The SMBv3.0.2 protocol. Microsoft Windows 8.1 and Windows Server 2012R2 |
| 3.11 | The SMBv3.1.1 protocol. Microsoft Windows 10 and Windows Server 2016 |
| 3 | The SMBv3.0 protocol version and above |

### Sharing a folder for use by Windows

Firstly, create a folder to share. This example creates a folder called `shared` in the `home` folder of the current user, and assumes the current user is `pi`.
Expand Down Expand Up @@ -105,3 +125,4 @@ workgroup = <your workgroup name here>
```

That should be enough to share the folder. On your Windows device, when you browse the network, the folder should appear and you should be able to connect to it.