| Both sides previous revision Previous revision Next revision | Previous revision |
| zfs [2025-06-27 21:15] – weichbr | zfs [2026-05-29 10:14] (current) – weichbr |
|---|
| ====== ZFS Cheatsheet ====== | ====== ZFS Cheatsheet ====== |
| |
| === Create a pool === | ==== Create a pool ==== |
| |
| * Get disk ids from ''/dev/disk/by-id'' | |
| | * Get disk ids from ''/dev/disk/by-id'', do not use ''/dev/sdX'' |
| * ''zpool create <name> <type> <disks>'' | * ''zpool create <name> <type> <disks>'' |
| * ''zpool create ssds mirror nvme-Samsung_SSD_980_TB_ABCD nvme-Samsung_SSD_980_TB_EFGH'' | * Example: ''zpool create ssds mirror nvme-Samsung_SSD_980_TB_ABCD nvme-Samsung_SSD_980_TB_EFGH'' |
| * Don't set ''ashift'', let zfs figure it out. You can check with ''zdb -C <pool>'' what value it uses. | * Don't set ''ashift'', let zfs figure it out. You can check with ''zdb -C <pool>'' what value it uses. |
| | * Only set it, if it's wrong. ''ashift=12'' for 4K physical sectors |
| * Set ''autotrim=on'' for SSDs | * Set ''autotrim=on'' for SSDs |
| | * When creating a pool ''-o'' is for pool options. To pass options to the root dataset, use ''-O''. |
| |
| === Create a dataset === | A good set of defaults for a new pool: |
| | ''-o autotrim=on -O acltype=posixacl -O xattr=sa -O normalization=formD -O compression=zstd -O atime=on -O relatime=on -O %%"%%com.sun:auto-snapshot%%"%%=false'' |
| | |
| | |
| | ==== Create a dataset ==== |
| |
| * ''zfs create <pool>/<dataset>'' | * ''zfs create <pool>/<dataset>'' |
| * Disabling ''atime'' is no longer necessary, just make sure that both ''atime'' and ''relatime'' are ''on'' | * Disabling ''atime'' is no longer necessary, just make sure that both ''atime'' and ''relatime'' are ''on'' |
| * For encryption specify: ''-o encryption=on -o keyformat=raw -o keylocation=file:/%%//%%path/to/key'' | * For encryption specify: ''-o encryption=on -o keyformat=raw -o keylocation=file:/%%//%%path/to/key'' |
| | * Enable comporession: ''-o compression=zstd'' |
| | * ''recordsize'' of 128K is default. When storing large files, e.g., media, set this higher, e.g., 1M |
| | |
| | Creating a dataset with encryption: |
| | '' echo -n password | zfs create pool/dataset -o compression=zstd -o normalization=formD -o xattr=sa -o acltype=posixacl -o atime=on -o relatime=on -o %%"%%com.sun:auto-snapshot%%"%%=false -o encryption=on -o keyformat=passphrase -o keylocation=file:/%%//%%dev/stdin'' |