ZFSh v0.0.1

ZFSh v0.0.1

ZFS Shell Helpers — simplified ZFS management for Linux.

Quick Install

git clone https://github.com/TemaSM/ZFSh.git /opt/zfsh && \
chmod +x /opt/zfsh/zfsh /opt/zfsh/*.sh && \
ln -s /opt/zfsh/zfsh /usr/local/bin/zfsh

Verify installation:

zfsh --version

See Getting Started for detailed installation options.

Quick Start

# Create 50GB ZFS pool
zfsh pool create default -s 50G -y

# Initialize Incus
zfsh incus init -p default -y

# Set up daily snapshots with retention
zfsh cron add --type snapshot --pool default --daily
zfsh cron add --type cleanup --pool default --daily \
    --keep-daily 7 --keep-weekly 4 --keep-monthly 3

See Basic Workflow for complete walkthrough.

Features

Feature	Description	Docs
Pool Management	Create, monitor, expand file-backed ZFS pools	zfsh pool
Snapshots	Create, list, rollback with GFS retention	zfsh snapshot
Backup & Restore	Local/remote backups with compression	zfsh backup
Incus Integration	One-command container setup	zfsh incus
Scheduling	Automated tasks via cron	zfsh cron

Documentation

• Full Documentation
• CLI Reference
• Backup Strategy Guide
• Retention Policies

Requirements

• Linux with ZFS (apt install zfsutils-linux)
• Bash 4.0+
• Root privileges