One-click install
npx skills add https://github.com/jmagar/claude-homelab --skill zfs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: zfs
Source: https://github.com/jmagar/claude-homelab/tree/main/skills/zfs
Command: npx skills add https://github.com/jmagar/claude-homelab --skill zfs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill helps administrators manage ZFS pools across multiple devices by providing health monitoring, automated snapshot management, cross-device replication, and proactive troubleshooting.

Core Features & Use Cases

  • Health checks and status reporting for ZFS pools with scrub status and capacity awareness.
  • Automated snapshot management using Sanoid/Syncoid, with guidance for retention, pruning, and restoration workflows.
  • Cross-device replication orchestration (pull-based) with staggered scheduling and delegation considerations for non-root operation.
  • Dataset property optimization (compression, atime, recordsize) and performance tuning for common homelab workloads.
  • Troubleshooting guidance and recovery procedures for degraded pools, replication failures, and capacity-related issues.

Quick Start

Install ZFS tooling and ensure SSH access between backup and source devices, then run a basic health check to verify pools are ONLINE.

Frequently Asked Questions about zfs

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

FAQPage Schema
How do I monitor ZFS pool health and check for degraded drives in a homelab?

You can monitor ZFS pool health by running automated checks that report pool status, scrub activity, and capacity usage across multiple devices, proactively identifying degraded states before data loss occurs.

How do I automate ZFS snapshot management and retention across multiple devices?

Automated ZFS snapshot management is handled through Sanoid and Syncoid, which provide guidance for retention, pruning, and restoration workflows to maintain staggered backup schedules across devices.

Can I run ZFS replication as a non-root user using SSH?

Yes, ZFS replication supports non-root operation through SSH-based remote management, providing delegation considerations and safety constraints for pull-based cross-device replication without requiring full root access.

What is the best way to optimize ZFS dataset properties like compression and recordsize for homelab workloads?

Optimizing ZFS dataset properties involves tuning compression, atime, and recordsize settings to match common homelab workloads, ensuring performance is balanced with storage efficiency across your pools.

Why is my ZFS replication failing and how do I recover a degraded pool?

ZFS replication failures and degraded pools are addressed through provided troubleshooting guidance and recovery procedures, resolving capacity-related issues and restoring pool health with enforced safety constraints for destructive operations.