wheels config set
Set configuration values for your Wheels application.
Usage
wheels config set <key>=<value> [--environment=<env>] [--encrypt]
Parameters
setting
- (Required) Key=Value pair for the setting to update--environment
- (Optional) Environment to apply settings to:development
,testing
,production
,all
. Default:development
--encrypt
- (Optional) Encrypt sensitive values
Description
The wheels config set
command updates configuration settings in your Wheels application. Settings must be provided in key=value
format.
Examples
Set basic configuration
wheels config set dataSourceName=wheels_production
Set for specific environment
wheels config set showDebugInformation=false --environment=production
wheels config set reloadPassword=newPassword --environment=production
Set for all environments
wheels config set defaultLayout=main --environment=all
Set encrypted value
wheels config set apiKey=sk_live_abc123 --encrypt
wheels config set dataSourcePassword=mySecret --encrypt
Configuration Values
The command accepts various value types:
String Values
wheels config set appName="My Wheels App"
wheels config set [email protected]
Boolean Values
wheels config set showDebugInformation=true
wheels config set cacheQueries=false
Numeric Values
wheels config set sessionTimeout=1800
wheels config set maxUploadSize=10485760
Where Settings Are Saved
Settings are saved to environment-specific configuration files:
Development:
/config/development/settings.cfm
Testing:
/config/testing/settings.cfm
Production:
/config/production/settings.cfm
All environments:
/config/settings.cfm
Example:
// Added to /config/production/settings.cfm
set(dataSourceName="wheels_production");
Sensitive Values
Use the --encrypt
flag for sensitive values:
wheels config set reloadPassword=mySecret --encrypt
wheels config set apiKey=sk_live_123456 --encrypt
Environment-Specific Settings
Target specific environments with the --environment
flag:
# Development only
wheels config set showDebugInformation=true --environment=development
# Production only
wheels config set cacheQueries=true --environment=production
# All environments
wheels config set appName="My App" --environment=all
Best Practices
Use environment-specific settings: Don't set production values in development
Encrypt sensitive data: Use
--encrypt
for passwords and keysTest changes: Verify settings with
wheels config list
Restart after changes: Some settings require application restart
Notes
Some settings require application restart
Encrypted values can't be read back
Changes are logged for audit
Use environment variables for containers
See Also
wheels config list - List configuration
wheels config env - Environment config
wheels env - Environment management
Last updated
Was this helpful?