Defining a New Persistent Storage Volume
Creating additional persistent storage volumes allows you to organize your application’s data storage according to your specific requirements. New volumes can be added to any environment beyond the inherited production defaults.
Creating a New Volume
Access Volume Creation
- Navigate to your environment’s details page
- Click on the Volumes tab
- Scroll to the “Define New Logical Volume” section
- Use the volume creation form to specify your new storage requirements
The form provides a streamlined interface for defining logical volumes that will be available for mounting into your containers.
Volume Configuration Fields
Volume Name (Required) Specify a unique identifier for your volume within the environment. The name should be descriptive and follow standard naming conventions:
- Use lowercase letters, numbers, and hyphens
- Examples:
user-uploads
,app-cache
,log-storage
,shared-assets
- Must be unique within the environment
- Cannot conflict with existing volume names
- Used when configuring container mount points
Description (Optional) Provide a clear explanation of the volume’s purpose and intended usage. Good descriptions help team members understand the volume’s role:
- “Persistent storage for user-uploaded files”
- “Application cache data for improved performance”
- “Shared configuration files across containers”
- “Development environment test data”
Automatic Path Assignment Quant Cloud automatically assigns the underlying storage directory path for your volume. The platform creates a unique path structure based on:
- Organization context
- Application name
- Environment name
- Volume name
This automatic path management ensures no conflicts occur while providing organized storage structure. The root directory will be automatically set to /{volume-name}
as indicated in the interface.
Creating the Volume
Submit Volume Definition After configuring the volume name and description, click “Define Volume” to create the new logical volume. The platform will:
- Validate the volume name for uniqueness and format
- Create the logical volume definition in the environment
- Prepare the underlying storage structure
- Make the volume available for container mounting
After Volume Creation
Volume Availability Once created, the new volume immediately appears in the “Defined Logical Volumes” list for the environment. The volume is now ready for use and can be mounted into any container within the same environment.
Next Steps for Usage To actually use the volume in your application:
- Configure Container Mount Points: Navigate to your environment’s “Edit Config” page
- Select Containers: Expand the containers that need access to this storage
- Add Mount Points: In the “Mount Points” section, select your new volume from the dropdown
- Specify Container Path: Define where the volume should be mounted inside the container
- Set Access Mode: Choose read-write or read-only access as appropriate
Volume Inheritance Volumes created in the production environment will automatically be inherited by new environments created after this volume definition. Existing environments will not automatically receive new volume definitions.
Common Volume Patterns
Application-Specific Storage
app-uploads
for user-generated contentapp-logs
for persistent application loggingapp-cache
for performance optimization storage
Service-Specific Storage
redis-data
for Redis persistenceelasticsearch-data
for search index storagenginx-cache
for web server caching
Environment-Specific Storage
staging-test-data
for staging environment testingdev-scratch
for development environment temporary storagebackup-storage
for environment-specific backup data
Properly organized volume definitions provide the foundation for reliable, scalable persistent storage across your application’s lifecycle.