Skip to main content

nifectl volumes Command Reference

Manage persistent volumes attached to applications.

Overview​

List persistent volumes associated with an application. Volumes provide durable storage that survives pod restarts and redeployments — essential for stateful workloads like databases.

Subcommands​

SubcommandDescription
volumes listList all volumes for an app
nifectl volumes <subcommand> [flags]

Options​

-a, --app string App name to operate on
-h, --help Help for volumes

Global Options​

-t, --access-token string Nife API Access Token
-j, --json JSON output format
-V, --verbose Verbose / debug output

Examples​

# List volumes for the current app
nifectl volumes list

# List volumes for a specific app
nifectl volumes list -a my-app

# Output as JSON
nifectl volumes list -a my-app --json

Creating Volumes​

Volumes are created during nifectl init using the --volume-size and --volume-path flags. To add a volume to an existing app, re-run nifectl init with the --overwrite flag.

Best Practices​

  • Always use volumes for database builtins (postgres, mysql, mongo, redis) to ensure data persistence.
  • Use --backup-volumes (the default in redeploy) to snapshot volumes before rolling out a new version.
  • Monitor volume usage regularly — a full volume will cause your application to crash.

See Also​

Summary​

Nifectl Volumes provides visibility into the persistent storage attached to your applications, ensuring your stateful workloads have the durable storage they need.