From 5c437d9f76fc88fb7ad550b4f69edb008eaaa64b Mon Sep 17 00:00:00 2001
From: Alexey Martemyanov <mallexxx@gmail.com>
Date: Sat, 23 May 2026 11:56:13 +0600
Subject: [PATCH] [2026-05-23] htpc-system: SMB config documented (disabled,
 homes share)

---
 family/how-to/htpc-system.md | 20 ++++++++++++++++++--
 1 file changed, 18 insertions(+), 2 deletions(-)

diff --git a/family/how-to/htpc-system.md b/family/how-to/htpc-system.md
index 2f9357ca..f73faf2d 100644
--- a/family/how-to/htpc-system.md
+++ b/family/how-to/htpc-system.md
@@ -149,8 +149,24 @@ journalctl -u htpc-sleep-guard -n 50 --no-pager
 
 ## SMB / Сетевые ресурсы
 
-`smb://htpc` — упоминается пользователем, но конфигурация **не задокументирована**.  
-Требует уточнения: что раздаётся, как настроено (Samba? systemd automount?).
+Hostname `htpc` резолвится через mDNS/avahi → отсюда `smb://htpc`.
+
+**Samba установлена** (`/etc/samba/smb.conf`), но `smb.service` — **disabled/inactive**.  
+Usershares включены (max 100, guests allowed), но кастомных шаров нет — директория пустая.
+
+Стандартный конфиг включает:
+- `[homes]` — шарит домашние директории при запущенном smbd
+- `[printers]` / `[print$]` — принтеры (CUPS)
+
+Чтобы запустить:
+```bash
+sudo systemctl enable --now smb nmb
+```
+
+Чтобы добавить шар:
+```bash
+net usershare add myshare /path/to/dir "Description" everyone:F guest_ok=yes
+```
 
 ## OSTree / Обновления
 - `/usr/local/bin` слетает при `rpm-ostree` upgrade (новый `/usr` overlay)