The Handbook

    Theme
    • Guides
        • Check a system before installing FreeBSD
        • Orient a Linux administrator on FreeBSD
        • Supported FreeBSD releases
        • Choose a FreeBSD documentation and support channel
        • Move files safely without GNU mv -t
        • Update and Upgrade FreeBSD
        • Upgrade 14.4 or 15.0 to FreeBSD 15.1
        • Choose packages, ports, or poudriere
        • Choose the quarterly or latest package branch
        • Choose a FreeBSD download or package mirror
        • Convert a test installation to pkgbase
        • Make a system setting persistent
        • Run a command from cron reliably
        • Configure locale, keyboard, and time zone
        • Configure a serial console for recovery
        • Choose a custom kernel, module, or loader setting
        • Run a Linux binary with the compatibility layer
        • Check desktop and laptop hardware before installation
        • Choose and check a graphics driver
        • Choose Xorg or Wayland
        • Build a maintainable desktop baseline
        • Install and check a desktop browser
        • Install GNOME and troubleshoot graphical login
        • Check laptop Wi-Fi, power, and suspend
        • Check multimedia readiness
        • Choose and configure a printing stack
        • Run Windows applications with Wine
        • Snapshot and replicate a ZFS dataset
        • Choose a filesystem and storage layout
        • Operate ZFS without losing the recovery path
        • Restore files from a ZFS snapshot
        • Find what is using ZFS space
        • Grow a ZFS virtual disk
        • Read ZFS pool health and run a scrub
        • Replace a failed device in a ZFS mirror
        • Replicate a ZFS dataset over SSH
        • Test changes in a writable ZFS clone
        • Read a ZFS pool from another FreeBSD system
        • Change PF safely on a remote host
        • Configure a narrow WireGuard tunnel
        • Share a directory with NFS
        • Share files with a named Samba account
        • Plan a FreeBSD home server
        • Choose a mail server or an outgoing relay
        • Publish a network service safely
        • Choose a jail network model
        • Choose native jails or a jail manager
        • Choose a jail or a bhyve virtual machine
        • Establish a FreeBSD security baseline
        • Choose a MAC policy
        • Audit security-relevant activity
        • Start a DTrace performance investigation
    • Integrations
        • Create a first jail with Bastille
        • Compare jail managers and OCI tooling
        • Publish a Bastille service through PF
        • Mount a ZFS dataset in a Bastille jail
        • Update and upgrade Bastille jails
        • Back up and restore a Bastille jail
        • Prepare bhyve and vm-bhyve
        • Install a Linux guest with vm-bhyve
        • Choose NFS or Samba for file sharing
        • Choose ZFS backup automation
        • Build a first signed poudriere repository
        • Operate a signed poudriere repository
        • Manage FreeBSD configuration with Ansible or Salt
        • Run Motion with webcamd on FreeBSD
        • Design a reverse proxy, certificates, and monitoring
    • FAQ
      • Troubleshooting
          • Recover an interrupted freebsd-update run
          • Resolve a package repository or ABI mismatch
          • Diagnose the FreeBSD boot path
          • Recover with a ZFS boot environment
          • Diagnose DNS, routing, and firewall paths
          • Diagnose network mbuf exhaustion
          • Bind a service to a low port without running it as root
          • Diagnose a service that will not start
          • Diagnose audio output or input
          • Diagnose webcamd, cuse, and a webcam
          • Fix USB device permissions without opening every device
      • About this handbook
      • Synopsis
      • Create the clone
      • Make changes in the clone
      • Remove the test copy
      • References

      Test changes in a writable ZFS clone

      Last reviewed
      21 November 2026
      Applies to
      15.1-RELEASE
      Tested on
      15.1-RELEASE

      Synopsis #

      A ZFS clone is a writable dataset created from a snapshot. It initially shares the snapshot’s blocks and consumes more space as files change. Use it to test data changes without modifying the source dataset.

      This example uses tank/data, an existing dataset, and creates tank/data-test. Replace tank with the pool name. For changes to the operating system itself, use a boot environment .

      Create the clone #

      Check the source dataset and available pool space. Choose an unused snapshot name, clone name, and mount point:

      # zfs list tank/data
      # zpool list tank
      # zfs snapshot tank/data@before-test
      # zfs clone -o mountpoint=/mnt/data-test tank/data@before-test tank/data-test
      # zfs get origin,mountpoint tank/data-test
      

      The clone contains the source data as it existed at the snapshot. Its origin should be tank/data@before-test and its mount point /mnt/data-test.

      A snapshot of a running database does not replace a database backup. Stop writes or follow the application’s backup procedure before taking the snapshot.

      Make changes in the clone #

      Work under /mnt/data-test, leaving the original mount point alone. Confirm the path before running tools that modify or delete files:

      $ df /mnt/data-test
      $ ls /mnt/data-test
      

      If an application will use the clone, change its data path and keep its ports, sockets, and services separate from the original instance. Creating the clone does not redirect applications automatically.

      Compare the changed files with the original dataset. Changes in the clone should leave the original unchanged. Monitor space while testing:

      # zfs list -o name,used,refer,mountpoint tank/data tank/data-test
      

      Remove the test copy #

      Save any results needed elsewhere and stop processes using the clone. The following commands permanently discard the test copy and then its source snapshot:

      # zfs destroy tank/data-test
      # zfs destroy tank/data@before-test
      

      The snapshot cannot be removed while the clone depends on it.

      References #

      • zfs clone(8)
      • Snapshot and replicate a ZFS dataset

      Independent documentation. Not affiliated with or endorsed by the FreeBSD Project or the FreeBSD Foundation.

      Report a bug
      • Synopsis
      • Create the clone
      • Make changes in the clone
      • Remove the test copy
      • References