TrueNAS-Tricks

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

★ 25 Open GitHub ↗

Prevent constant waking of TrueNAS HDDs for smartctl tasks, and other TrueNAS stuff

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

## 💤 TrueNAS Spindown Patch Helper

### **Supports TrueNAS 25.x and 26.x**.  Full instructions [here](https://github.com/itiligent/TrueNAS-Tricks/blob/main/spindown-fix-instructions.md)

️`spindown-fix.sh` provides a safe, reversible method for applying the TrueNAS HDD spindown patch **without directly modifying the TrueNAS filesystem**.
- Automatically copies the required TrueNAS middleware files into a new overlay location
- Applies `spindown-[version].patch` to the overlay file copies
- Bind-mounts the patched overaly files over the original files (leaving the original TrueNAS system untouched)
- Upgrade friendly - This script can be run multiple times to roll back and re-patch after updates.
---

## 🔎 TrueNAS HDD Wake Trace

`hdd-wake-trace.sh` is an advanced diagnostic tool for TrueNAS SCALE that helps identify **what is waking HDDs from standby** in a ZFS pool.

The script monitors spinning disks in a selected TrueNAS pool. When one or more disks transition from `standby` or `sleeping` to `active/idle`, it creates detailed wake-event logs and correlates system activity across a configurable time window before and after the wake event.

It can help trace recurring wake causes across areas such as:

- SMB access
- SMART polling
- ZFS activity
- TrueNAS middleware jobs
- Process I/O
- System timers
- Block-level disk activity

By analysing repeated wake events over time, the script builds a much higher-confidence picture of the likely root cause than reviewing isolated logs manually.

Built-in profiles allow different levels of capture detail, from lower-noise monitoring through to deep debug tracing for difficult wake-cause investigations.

📘 Full documentation: [hdd-wake-trace documentation](https://github.com/itiligent/TrueNAS-Tricks/blob/main/hdd-wake-trace-documentation.md)

---

## 📧 TrueNAS Email SMART Reports

The maximum size of email messages from TrueNAS middleware is too limited to send detailed SMART reports. `smart-report.py` works around this by creating comprehensive disk health reports from `smartctl` output and sending them via Python using the TrueNAS API.

The included companion script, `smart-report-api-key-setup.sh`, helps install a GUI-generated TrueNAS API key that the python script will call.

## 💾 TrueNAS External USB Mount Helper

`external-usb.sh` is an interactive Bash utility for safely mounting and unmounting external USB storage devices on TrueNAS.

The script automatically detects connected USB partitions, presents them in a device selection menu, and mounts the chosen device to a fixed mountpoint (`/mnt/external`) with shared read/write access enabled.  The script also sets compatible permissions and ownership settings for data on the external USB mountpoint to allow for easy permissions compatibiltiy between TrueNAS and regular Linux hosts.

TrueNAS-Tricks

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README