hermes-skills/truenas/SKILL.md

name, description, version, tags

name	description	version	tags
truenas	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.	1.0.0	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

smbclient -N -L //10.0.0.117

Browse a share (interactive)

smbclient -N //10.0.0.117/data
smbclient -N //10.0.0.117/proxmoxBackup

List top-level directories (non-interactive)

smbclient -N //10.0.0.117/data -c "ls"
smbclient -N //10.0.0.117/proxmoxBackup -c "ls"

List contents of a specific directory

smbclient -N //10.0.0.117/data -c "ls <dirname>/*"

Search for files by pattern

smbclient -N //10.0.0.117/data -c "ls *" 2>/dev/null | grep -i "<pattern>"

Download a single file

smbclient -N //10.0.0.117/data -c "cd <dirname>; get <filename> <local_path>"

Download a directory recursively

smbclient -N //10.0.0.117/data -c "cd <dirname>; prompt OFF; recurse ON; mget *"

Mount read-only (for persistent access)

sudo mkdir -p /mnt/green_data
sudo mount.cifs //10.0.0.117/data /mnt/green_data -o ro,guest,vers=3.0

Unmount

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.