lvm Cookbook

June 17, 2026 · View on GitHub

Resource-driven cookbook for managing LVM physical volumes, volume groups, and logical volumes using LVM2 built-in JSON reporting.

Maintainers

This cookbook is maintained by the Sous Chefs. The Sous Chefs are a community of Chef cookbook maintainers working together to maintain important cookbooks. If you'd like to know more please visit sous-chefs.org or come chat with us on the Chef Community Slack in #sous-chefs.

Requirements

Platforms

AlmaLinux 8+
Amazon Linux 2023+
CentOS Stream 9+
Debian 12+
Fedora (latest)
openSUSE Leap 15+
Oracle Linux 8+
Rocky Linux 8+
Ubuntu 22.04+

Chef

Chef >= 16.0

LVM2

LVM2 >= 2.02.158 (released 2017; required for --reportformat json support)

Cookbooks

none

Usage

Declare a dependency on lvm in your cookbook metadata:

# your_cookbook/metadata.rb
depends 'lvm'

Then use the resources directly in your recipes:

# Create a physical volume
lvm_physical_volume '/dev/sdb'

# Create a volume group from physical volumes
lvm_volume_group 'data' do
  physical_volumes ['/dev/sdb']
end

# Create a logical volume
lvm_logical_volume 'logs' do
  group      'data'
  size       '10G'
  filesystem 'ext4'
  mount_point '/var/log/app'
end

# Create a thin pool inside a volume group
lvm_thin_pool 'pool0' do
  group 'data'
  size  '50G'
end

# Create a thin volume from a thin pool
lvm_thin_volume 'app' do
  group     'data'
  pool      'pool0'
  size      '20G'
  filesystem 'xfs'
  mount_point '/srv/app'
end