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​
| Subcommand | Description |
|---|---|
volumes list | List 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​
nifectl init– Create a volume during app initialisationnifectl redeploy– Redeploy with volume backupnifectl– The Nife CLI home command
Summary​
Nifectl Volumes provides visibility into the persistent storage attached to your applications, ensuring your stateful workloads have the durable storage they need.