From 7ac4df0dc3a4e53bcc4fb1b4f0bf3deacc201f09 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?St=C3=A9phane=20Graber?= Date: Thu, 20 Nov 2025 14:38:01 -0500 Subject: [PATCH] doc: Cover storage pool volumes MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Stéphane Graber --- doc/reference/system/storage.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/doc/reference/system/storage.md b/doc/reference/system/storage.md index e33b960..7d87869 100644 --- a/doc/reference/system/storage.md +++ b/doc/reference/system/storage.md @@ -90,3 +90,26 @@ If importing an existing storage pool, IncusOS needs to be informed of its encry ``` incus admin os system import-storage-pool -d '{"name":"mypool","type":"zfs","encryption_key":"THp6YZ33zwAEXiCWU71/l7tY8uWouKB5TSr/uKXCj2A="}' ``` + +## Managing volumes + +It's possible to create and delete volumes within a storage pool. + +Each volume has its own: + +* Name +* Quota (in bytes, a zero value means unrestricted) +* Use (`incus` or `linstor`) + +The list of volumes are visible directly in the storage state data. + +Creating and deleting volumes can be done through the command line with: + +``` +incus admin os system storage create-volume -d '{"pool":"local","name":"my-volume","use":"linstor"}' +incus admin os system storage delete-volume -d '{"pool":"local","name":"my-volume"}' +``` + +```{note} +IncusOS automatically creates a new `incus` volume when setting up the `local` storage pool. +```