1. When to use it
Useful when you want a share readable from Windows or other SMB clients without broad anonymous access.
Samba | smbpasswd | pdbedit | smbclient | users
2. Base setup
smbpasswd -a alice
testparm -s
pdbedit -L
Adjust host names, IPs, interfaces, paths, and versions to the real system before making the change persistent.
3. Quick verification
smbclient -L //127.0.0.1 -U alice
grep -n '^\[homes\]' /etc/samba/smb.conf
id alice
Confirm that the output matches the expected state before considering the intervention complete.
4. Operational notes
Remember that both the Unix user and the Samba user must exist, otherwise authentication remains half-configured.
Quick checklist
[ ] Steps completed\n[ ] Config updated\n[ ] Tests executed\n[ ] Rollback ready\n[ ] Logs checked