+[[storage_zfspool]]
Local ZFS Pool Backend
----------------------
-include::attributes.txt[]
+ifdef::wiki[]
+:pve-toplevel:
+:title: Storage: ZFS
+endif::wiki[]
Storage pool type: `zfspool`
-This backend allows you to access local ZFS pools (or ZFS filesystems
+This backend allows you to access local ZFS pools (or ZFS file systems
inside such pools).
+
Configuration
~~~~~~~~~~~~~
Use ZFS thin-provisioning. A sparse volume is a volume whose
reservation is not equal to the volume size.
-.Configuration Example ('/etc/pve/storage.cfg')
+mountpoint::
+
+The mount point of the ZFS pool/filesystem. Changing this does not
+affect the `mountpoint` property of the dataset seen by `zfs`.
+Defaults to `/<pool>`.
+
+.Configuration Example (`/etc/pve/storage.cfg`)
----
zfspool: vmdata
pool tank/vmdata
sparse
----
+
File naming conventions
~~~~~~~~~~~~~~~~~~~~~~~
`<NAME>`::
-This scan be an arbitrary name (`ascii`) without white spaces. The
+This can be an arbitrary name (`ascii`) without white space. The
backend uses `disk[N]` as default, where `[N]` is replaced by an
integer to make the name unique.
|images rootdir |raw subvol |no |yes |yes
|==============================================================================
+
Examples
~~~~~~~~
-It is recommended to create and extra ZFS filesystem to store your VM images:
+It is recommended to create an extra ZFS file system to store your VM images:
# zfs create tank/vmdata
-To enable compression on that newly allocated filesystem:
+To enable compression on that newly allocated file system:
# zfs set compression=on tank/vmdata
You can get a list of available ZFS filesystems with:
# pvesm zfsscan
+
+ifdef::wiki[]
+
+See Also
+~~~~~~~~
+
+* link:/wiki/Storage[Storage]
+
+* link:/wiki/ZFS_on_Linux[ZFS on Linux]
+
+endif::wiki[]