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
      • Identify the pool
      • Import without mounting datasets
      • Mount and copy the needed files
      • References

      Read a ZFS pool from another FreeBSD system

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

      Synopsis #

      Attach an existing ZFS pool’s disks to another FreeBSD system, import the pool read-only, and copy files out. An alternate root keeps its datasets away from the running system’s normal mount points.

      Use a FreeBSD release that supports the pool’s enabled features. For damaged or failing disks, make disk images before attempting recovery. This procedure reads an intact pool; it does not repair corruption or recover deleted files.

      Identify the pool #

      Shut down the original system or export the pool there before moving its disks. Never import a pool that another system is still using.

      On the recovery system, identify the attached devices and available pools:

      # geom disk list
      # zpool import
      

      Check the pool’s name, numeric ID, disks, and reported state. Use its numeric ID if another pool has the same name. Do not create a pool or run an installer on these disks.

      Import without mounting datasets #

      Create an empty recovery directory. Replace POOL_ID with the ID reported above:

      # mkdir -p /mnt/recovery
      # zpool import -N -o readonly=on -R /mnt/recovery POOL_ID
      # zpool status
      # zpool get readonly,altroot POOL
      # zfs list -r -o name,mountpoint,canmount POOL
      

      Replace POOL with the imported pool’s name. Confirm readonly is on and altroot is /mnt/recovery before mounting anything. If import reports an unsupported feature, missing devices, or a pool still in use, resolve that condition first. Do not add force or rewind options merely to get past the error.

      Mount and copy the needed files #

      Mount a specific filesystem dataset, using the name from zfs list:

      # zfs mount POOL/data
      # zfs mount
      

      Confirm the resulting mount is beneath /mnt/recovery. A dataset whose normal mount point is /data appears at /mnt/recovery/data. Datasets with legacy mount points need an explicit read-only mount; encrypted datasets need their keys before they can be mounted.

      Copy the required files to a different, writable disk. For example, with /backup on that disk:

      # cp -Rp /mnt/recovery/data/documents /backup/
      

      Check that the copied files are readable. Once finished, leave the recovery directory, close programs using it, and export the pool:

      # cd /
      # zpool export POOL
      

      References #

      • zpool import(8)
      • zfs mount(8)
      • Restore files from a ZFS snapshot

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

      Report a bug
      • Synopsis
      • Identify the pool
      • Import without mounting datasets
      • Mount and copy the needed files
      • References