Overview
Volumes are persistent block storage devices that can be attached to compute instances. They persist independently of the instance lifecycle — detach, reattach, snapshot, or transfer them between projects as needed.Prerequisites
- An active Polystack account with appropriate permissions
- Access to the Polystack Dashboard or CLI configured with credentials
- API credentials sourced (
source openrc.sh)
Data Source Types
Create a Volume
- Dashboard
- CLI
1
Navigate to Volumes
Navigate to Storage > Volumes in the sidebar. Click Create Volume.
The create form opens as a full page.
2
Select the data source
Choose the Data Source Type:
When Image is selected, an image selection table appears with tabs organized
by OS distribution (CentOS, Ubuntu, Fedora, Windows, etc.).When Snapshot is selected, a snapshot selection table appears showing available
snapshots with their size and status.
3
Select a volume type
Choose the Volume Type from the available storage tiers. The table shows
all configured volume types with their properties.
4
Set the capacity
Enter the Capacity (GiB) using the slider or input field.
- Blank volume: minimum 1 GiB
- Image source: minimum is the image’s
min_diskrequirement - Snapshot source: minimum is the snapshot’s original size
5
Configure name and description
6
Set the availability zone (optional)
Select an Available Zone from the dropdown. If not specified, the system
selects the default zone.
The volume’s availability zone should match the zone of the instance you
plan to attach it to.
7
Create the volume
The footer shows the Count field (default: 1) to create multiple identical
volumes in one operation. Real-time quota usage is displayed.Click Confirm. The volume appears in the list with status Creating,
transitioning to Available when ready.
Volume status is Available — ready to attach to an instance.
View Volumes
- Dashboard
- CLI
Navigate to Storage > Volumes. The list shows:
Filter by Name or Status.
Volume Detail
- Dashboard
- CLI
Click a volume name to open the detail page. The header shows volume name,
description, shared status, current status, size, creation time, type, and
encryption status.Three tabs are available:
- Detail — Base information, attachment details, source snapshot/image links
- Volume Backups — All backups created from this volume
- Volume Snapshots — All snapshots of this volume
Next Steps
Attach a Volume
Connect this volume to a compute instance
Volume Snapshots
Create point-in-time snapshots of your volumes
Volume Types
Understand available storage tiers
Extend a Volume
Increase volume capacity without data loss
