truenas-ops

Configure ZFS datasets, shares, snapshots, scrubs, and replication on TrueNAS SCALE/CORE.

8|1|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/drewid74/ai_skills --skill truenas-ops
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: truenas-ops
Source: https://github.com/drewid74/ai_skills/tree/main/truenas-ops
Command: npx skills add https://github.com/drewid74/ai_skills --skill truenas-ops

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you run reliable, safe TrueNAS SCALE/CORE operations—setting up shares, managing datasets, fixing permissions, scheduling snapshots/scrubs, and designing correct replication—while avoiding common ZFS misconfigurations that lead to data loss or broken access.

Core Features & Use Cases

  • Dataset and share configuration: Establish dataset layouts and SMB/NFS share setup that works cleanly with container workloads and ACL/POSIX permissions.
  • ZFS integrity and lifecycle controls: Define record size strategy, automated snapshot policies, and scheduled scrubs to detect and prevent corruption.
  • Replication and migration guidance: Configure ZFS send/recv over SSH for local/remote/offsite replication, and outline a safe CORE-to-SCALE migration path.

Use case: You need an SMB share that’s accessible from your network and writable by Docker containers, while also ensuring monthly scrubs, automated snapshots, and offsite replication are correctly configured.

Quick Start

Ask your AI to produce a TrueNAS dataset + snapshot + scrub + SSH replication plan for your SMB/NFS share, including the correct record size and container PUID/PGID permission strategy, based on your current pool health and the intended workload type.

Frequently Asked Questions about truenas-ops

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure TrueNAS ZFS datasets for SMB shares that are writable by Docker containers?

TrueNAS ZFS dataset permissions for Docker containers require matching ACL/POSIX ownership to the container's PUID/PGID values, ensuring SMB shares remain accessible across the network while allowing seamless container read and write operations.

What is the correct record size to select for a TrueNAS ZFS dataset?

ZFS record size selection depends on your specific workload type, but you must avoid changing record sizes after data has been written to the dataset to prevent performance degradation and maintain data integrity.

How do I set up ZFS send and recv replication over SSH for offsite TrueNAS backups?

ZFS send and recv replication over SSH for TrueNAS offsite backups requires configuring SSH connectivity between local and remote systems, designing encryption-aware replication tasks, and verifying snapshot transfers to ensure data integrity.

When should I avoid using ZFS deduplication on TrueNAS?

You should avoid enabling ZFS deduplication on TrueNAS pools using mechanical disks, as it heavily impacts performance and can lead to severe bottlenecks during read and write operations on non-NVMe storage.

How do I schedule ZFS scrubs and automated snapshots in TrueNAS to prevent corruption?

Scheduling ZFS scrubs and automated snapshots in TrueNAS involves configuring regular scrub tasks to detect pool corruption and setting snapshot policies to capture dataset states, ensuring you can recover data from unintended loss.

Does TrueNAS CORE to SCALE migration affect existing ZFS dataset layouts and SMB NFS shares?

Migrating from TrueNAS CORE to SCALE requires following a safe migration path to preserve existing ZFS dataset layouts and SMB/NFS share configurations, ensuring container-compatible permissions and access controls remain intact.