Skip to main content

​
vers rootfs

Commands to list and delete rootfs images on the Vers platform.

​
Usage

vers rootfs list                      # List available rootfs images
vers rootfs delete [rootfs-name]      # Delete a specific rootfs image
vers rootfs delete [rootfs-name] -f   # Delete without confirmation

​
Commands

​
vers rootfs list

List all available rootfs images on the Vers platform. 
vers rootfs list
Fetching available rootfs images...
Available rootfs images:
- default
- ubuntu-dev
- my-python-app
- node-16-env

​
vers rootfs delete

Delete a specific rootfs image from the Vers platform.
OptionDescription
--force, -fForce deletion without confirmation

​
Examples

​
List available images

vers rootfs list
Fetching available rootfs images...
Available rootfs images:
- default
- my-custom-image
- experimental-build

​
Delete with confirmation

vers rootfs delete my-old-image
⚠ Are you sure you want to delete rootfs 'my-old-image'? This action cannot be undone. [y/N]: y
Deleting rootfs 'my-old-image'...
✓ Successfully deleted rootfs 'my-old-image'

​
Delete without confirmation

vers rootfs delete --force temp-build
Deleting rootfs 'temp-build'...
✓ Successfully deleted rootfs 'temp-build'

​
Check before deleting

# See what's available
vers rootfs list

# Delete unused ones
vers rootfs delete old-experiment
vers rootfs delete -f test-image-v1

​
How it works

​
List command

  1. Fetches images: Makes API call to get available rootfs images
  2. Displays results: Shows image names in a simple list format
  3. Handles empty: Shows “No rootfs images found” if none exist

​
Delete command

  1. Confirmation: Prompts for confirmation unless --force is used
  2. API deletion: Makes delete request for the specified image
  3. Progress display: Shows deletion progress
  4. Success confirmation: Confirms successful deletion

​
Error handling

​
Image not found

vers rootfs delete nonexistent-image
Error: failed to delete rootfs 'nonexistent-image': not found

​
User cancellation

vers rootfs delete my-image
⚠ Are you sure you want to delete rootfs 'my-image'? This action cannot be undone. [y/N]: n
Operation cancelled

​
API failures

vers rootfs list
Error: failed to list rootfs images: connection timeout

​
Use cases

​
Storage cleanup

# Review what you have
vers rootfs list

# Clean up old builds
vers rootfs delete old-version-1
vers rootfs delete old-version-2
vers rootfs delete experimental-test

​
Batch deletion

# Delete multiple images efficiently
vers rootfs delete -f temp-image-1
vers rootfs delete -f temp-image-2
vers rootfs delete -f temp-image-3

​
Before project cleanup

# Check current project configuration
cat vers.toml

# Delete images not referenced in vers.toml
vers rootfs delete unused-image

​
Prerequisites

  • Authentication with Vers platform
  • Network connectivity to access the API
  • Appropriate permissions to delete rootfs images

​
See Also