NAME

zelta - perform safe, recursive ZFS operations locally and remotely

SYNOPSIS



    zelta -V | \--version | version


    zelta SUBCOMMAND [OPTIONS] [ARGUMENTS]

DESCRIPTION

zelta provides tools for ZFS replication, backup verification, dataset recovery, and policy-based automation. All operations work recursively on dataset trees and support both local and remote execution via ssh(1).

Remote dataset endpoints follow scp(1) conventions. Operations can be performed without installing zelta on remote systems—only standard ZFS utilities and SSH access are required.

Examples:

Local:  pool/dataset@snapshot
Remote: user@example.com:pool/dataset@snapshot

See zfs(8) for dataset naming conventions.

SUBCOMMANDS

For detailed usage of each subcommand, run zelta help or see the respective manual page.

zelta -?: Display help message.
zelta -V, --version, version: Display version information.

Comparison

zelta match source target: Compare two dataset trees and report matching snapshots or discrepancies. See zelta-match(8).

Replication

zelta backup source target: Replicate a dataset tree. Creates snapshots if needed, detects optimal send options, and replicates intermediate snapshots. See zelta-backup(8).

Recovery

zelta clone dataset target: Create a writable clone of a dataset tree. See zelta-clone(8).
zelta revert dataset: Rewind a dataset to a previous snapshot by renaming and cloning. Preserves current state. See zelta-revert(8).
zelta rotate source target: Preserve divergent dataset versions through rename and clone operations. See zelta-rotate(8).

Automation

zelta policy [options]: Execute replication operations based on configuration file definitions. See zelta-policy(8).

OPTIONS AND ENVIRONMENT

Configuration follows a hierarchy from lowest to highest precedence:

1. Internal defaults
2. `/usr/local/etc/zelta/zelta.env`
3. Policy configuration (`zelta.conf`)
4. Environment variables
5. Command-line arguments

See zelta-options(7) for details.

FILES

/usr/local/etc/zelta/zelta.conf: Default policy configuration file.
/usr/local/etc/zelta/zelta.env: Global default setting overrides.

EXAMPLES

The following examples use “sink” as the source pool and “tank” as the backup target.

Replicate a dataset to a remote host:

zelta backup sink/data/project backupuser@backup-host.example:tank/backups/project

Compare local and remote dataset trees:

zelta match sink/data remote:tank/backups

Revert a dataset to its previous snapshot:

zelta revert sink/data/project

Update a target that has diverged:

zelta rotate sink/data/project backupuser@backup-host.example:tank/backups/project

Back up everything defined in policy settings (zelta.conf).

zelta policy

EXIT STATUS

Returns 0 on success, non-zero on error.

AUTHORS

Daniel J. Bell <bellhyve@zelta.space>

WWW

https://zelta.space