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 keys
Test 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