wheels env list
List all available environments for your Wheels application.
Synopsis
Description
The wheels env list
command displays all configured environments in your Wheels application. It shows environment details, current active environment, and configuration status.
Options
--format
Output format (table, json, yaml)
table
--verbose
Show detailed configuration
false
--check
Validate environment configurations
false
--filter
Filter by environment type
All
--sort
Sort by (name, type, modified)
name
--help
Show help information
Examples
List all environments
Show detailed information
Output as JSON
Check environment validity
Filter production environments
Output Example
Basic Output
Verbose Output
JSON Output Format
Environment Status
Status Indicators
✓ Valid
- Configuration is valid and working✓ Active
- Currently active environment⚠ Issues
- Configuration issues detected✗ Invalid
- Configuration errors
Validation Checks
When using --check
:
Configuration file exists
Syntax is valid
Database connection works
Required settings present
Environment Types
Standard Types
Development: Local development
Testing: Automated testing
Staging: Pre-production
Production: Live environment
Custom Types
User-defined environments
Special purpose configs
Client-specific setups
Filtering Options
By Type
By Status
By Pattern
Sorting Options
By Name
By Type
By Last Modified
Integration
Script Usage
CI/CD Usage
Environment Details
When using --verbose
, shows:
Configuration:
Config file path
Last modified date
File size
Database:
Database name
Datasource name
Connection status
Settings:
Debug mode
Cache settings
Custom configurations
Validation:
Syntax check
Connection test
Dependencies
Troubleshooting
No Environments Listed
Check
/config/
directoryVerify environment.cfm exists
Run
wheels env setup
to create
Invalid Environment
Check configuration syntax
Verify database credentials
Test database connection
Missing Current Environment
Check WHEELS_ENV variable
Verify environment.cfm logic
Set environment explicitly
Export Capabilities
Export Configuration
Environment Comparison
Best Practices
Regular Checks: Validate environments periodically
Documentation: Keep environment purposes clear
Consistency: Use consistent naming
Cleanup: Remove unused environments
Security: Don't expose production details
Notes
Current environment marked with asterisk (*)
Invalid environments shown but marked
Verbose mode may expose sensitive data
JSON format useful for automation
See Also
wheels env - Environment management overview
wheels env setup - Setup new environment
wheels env switch - Switch environments
wheels config list - List configuration
Last updated
Was this helpful?