truenas: v1.0.0 (new to repo) — workspace-context-organization, youtube-content: add version field — ecosystem-surveillance: v1.1.0 sync

truenas/SKILL.md

@@ -0,0 +1,107 @@
+---
+name: truenas
+description: "Access the TrueNAS server at 10.0.0.117 (alias green) — browse shares, mount, search, and copy files. Two SMB shares: data (read-only) and proxmoxBackup."
+version: 1.0.0
+tags: [truenas, nas, smb, storage, green, network-storage]
+---
+
+# TrueNAS Access
+
+**Server:** 10.0.0.117 (alias: `green`, `smb://green.local/`)
+**Protocol:** SMB (SMB1 disabled)
+**Auth:** None — guest access on both shares
+
+## Shares
+
+| Share | Access | Contents |
+|---|---|---|
+| `data` | Read-only, no creds | Backups, media, docs, docker configs, photos, videos, AI files |
+| `proxmoxBackup` | Read-write, no creds | Proxmox dumps, UniFi backups, snippets, images, i9Bkup, templates |
+
+## Quick Commands
+
+### List shares
+```bash
+smbclient -N -L //10.0.0.117
+```
+
+### Browse a share (interactive)
+```bash
+smbclient -N //10.0.0.117/data
+smbclient -N //10.0.0.117/proxmoxBackup
+```
+
+### List top-level directories (non-interactive)
+```bash
+smbclient -N //10.0.0.117/data -c "ls"
+smbclient -N //10.0.0.117/proxmoxBackup -c "ls"
+```
+
+### List contents of a specific directory
+```bash
+smbclient -N //10.0.0.117/data -c "ls <dirname>/*"
+```
+
+### Search for files by pattern
+```bash
+smbclient -N //10.0.0.117/data -c "ls *" 2>/dev/null | grep -i "<pattern>"
+```
+
+### Download a single file
+```bash
+smbclient -N //10.0.0.117/data -c "cd <dirname>; get <filename> <local_path>"
+```
+
+### Download a directory recursively
+```bash
+smbclient -N //10.0.0.117/data -c "cd <dirname>; prompt OFF; recurse ON; mget *"
+```
+
+### Mount read-only (for persistent access)
+```bash
+sudo mkdir -p /mnt/green_data
+sudo mount.cifs //10.0.0.117/data /mnt/green_data -o ro,guest,vers=3.0
+```
+
+### Unmount
+```bash
+sudo umount /mnt/green_data
+```
+
+## data Share — Top-Level Contents
+
+| Directory | Description |
+|---|---|
+| `ai/` | AI-related files |
+| `adm1n-ROG/`, `adm1n-ROG-1/` | ROG machine backups |
+| `AllPictures/`, `Picture_All_Sorted/`, `Pictures/`, `CurrentPics/`, `Photo/`, `images/` | Photo collections |
+| `Video/`, `VideoAllSorted/`, `Z_Movies/`, `Z_TV/` | Video/media |
+| `BackupData/`, `NAS8_BKUP/`, `MS01_Backup/`, `MSI_Backup/`, `PC_Backup/`, `i7/` | Machine backups |
+| `DOCKER/` | Docker configurations |
+| `KeepForeverDocs/`, `PDF Document/`, `DOCS FOR DEB2/` | Documents |
+| `MINI_WEB_SITE/` | Website files |
+| `minix/`, `minix2/` | Minix-related |
+| `Sorted/` | Sorted files |
+| `UnifiProtect/` | UniFi Protect backups |
+
+## proxmoxBackup Share — Top-Level Contents
+
+| Directory | Description |
+|---|---|
+| `dump/` | Proxmox VM/CT dumps |
+| `i9Bkup/` | i9 machine backup |
+| `UniFi/` | UniFi controller backups |
+| `snippets/` | Code/config snippets |
+| `images/` | Images |
+| `template/` | Templates |
+| `import/` | Import files |
+| `private/` | Private data |
+
+## Pitfalls
+
+- **SMB1 is disabled** — `-N` (no password) works for guest access. If you get auth errors, the share may have been reconfigured.
+- **data share is read-only** — you cannot write, delete, or modify files on the `data` share via SMB. Use `proxmoxBackup` for writes.
+- **smbclient needs sudo** on some systems if the smbclient binary isn't in the user's PATH or if mount.cifs is used.
+- **Spaces in directory names** — quote paths with spaces, e.g., `"PDF Document"` or `"DOCS FOR DEB2"`.
+- **Large transfers** — for bulk downloads, mount with `mount.cifs` and use `cp`/`rsync` instead of smbclient's `mget`.
+- **No workgroup** — SMB1 disabled means no workgroup browsing. Direct IP access only.