Community Solution

Use Existing ZFS Pools With CasaOS on Debian

A Debian 12 CasaOS user successfully installed OpenZFS and imported existing TrueNAS ZFS pools so CasaOS could access the mounted data.

Bottom Line: CasaOS Can Use a ZFS Pool When the Underlying Linux Host Owns ZFS

CasaOS itself does not need to be the layer that installs or manages ZFS. In the successful 2024 setup, Debian 12 installed OpenZFS, imported the existing pool, and CasaOS then saw the mounted data through the host filesystem.

Install OpenZFS Through the Host Distribution

On Debian, use the distribution-specific OpenZFS installation path rather than copying package names from an old post blindly. The current OpenZFS getting started links to Debian-specific instructions. Debian's Debian ZFS packages covers package availability.

Discover the Pool Before Importing It

sudo zpool import

This lists importable pools without immediately importing one. If the pool came from another machine, read the reported state and pool name carefully before using -f.

Do Not Use zpool import -f as the First Reflex

-f overrides the protection that says the pool may be active on another host. Use it only after you know the old host is offline and the pool is not still mounted elsewhere. OpenZFS's import behavior is designed to prevent accidental simultaneous ownership.

CasaOS Only Needs a Stable Mount Path

Once Debian imports and mounts the pool, point CasaOS shares/apps at that host path. The UI does not need to recreate the pool. Keep ZFS management at the Linux/OpenZFS layer and app/file access at the CasaOS layer.

If you are migrating this architecture to ZimaOS, the ZimaOS data migration helps separate application data from storage management.

ZFS on Debian Is Different From ZimaOS-Managed RAID

Do not mix ZFS pool commands with mdadm RAID instructions. They use different metadata and recovery models. For a current integrated multi-drive platform, the ZimaCube 2 storage provides the hardware context.