Skip to content

Problems

DatuX edited this page Nov 13, 2026 · 12 revisions

Common problems you might encounter

It keeps asking for my SSH password

You did not set up an SSH login with keys. See Set up SSH login.

"cannot receive incremental stream: destination has been modified since most recent snapshot"

The target dataset has changes. Read Mounting first.

  • Always use --clear-mountpoint. See Mounting.
  • Set readonly=on on the target dataset. This prevents changes to the contents of the dataset. zfs-autobackup can still receive new datasets and change properties.
  • Use --rollback to remove the changes automatically.

"cannot receive incremental stream: invalid backup stream"

Usually this occurs when you make a snapshot on the target during a backup. Run zfs-autobackup again. It removes the partially received snapshot and starts again.

"internal error: Invalid argument"

The target system does not fully support some properties. This can occur, for example, from Linux to FreeBSD.

Try --filter-properties xattr or --ignore-transfer-errors.

zfs receive fails, but snapshot seems to be received successful.

This occurs between different operating systems, ZFS versions or feature sets.

Use --ignore-transfer-errors. zfs-autobackup then ignores the error, but still checks that it received the snapshot.

"cannot receive incremental stream: kernel modules must be upgraded to receive this stream."

The target datasets are encrypted and you did not use --encrypt. See Encryption.

"dataset is busy"

There can be different causes. First, look for holds on the snapshot:

zfs holds zpool/fs1@snapshot1

Use zfs release to remove a hold. To not use holds, use --no-holds. Read Common snapshots and holds before you do this.

Other problems

Clone this wiki locally