Command Line Tools
wheels reload
wheels reload
Section titled “wheels reload”Reload the Wheels application in different modes.
Synopsis
Section titled “Synopsis”wheels reload [options]wheels r [options]Description
Section titled “Description”The wheels reload command reloads your Wheels application, clearing caches and reinitializing the framework. This is useful during development when you’ve made changes to configuration, routes, or framework settings. Note: the server must be running for this command to work.
Arguments
Section titled “Arguments”| Argument | Description | Default |
|---|---|---|
mode | Reload mode: development, testing, maintenance, production | development |
password | The reload password configured in your application | Empty |
Configuration
Section titled “Configuration”Set the reload password in your Wheels settings.cfm:
set(reloadPassword="mySecretPassword");Reload Modes
Section titled “Reload Modes”Development Mode
Section titled “Development Mode”wheels reload password=mypassword- Enables debugging
- Shows detailed error messages
- Disables caching
- Ideal for active development
Testing Mode
Section titled “Testing Mode”wheels reload mode=testing password=mypassword- Optimized for running tests
- Consistent environment
- Predictable caching
Maintenance Mode
Section titled “Maintenance Mode”wheels reload mode=maintenance password=mypassword- Shows maintenance page to users
- Allows admin access
- Useful for deployments
Production Mode
Section titled “Production Mode”wheels reload mode=production password=mypassword- Full caching enabled
- Minimal error information
- Optimized performance
Security
Section titled “Security”- The reload password must match the one configured in your Wheels application
- Password is sent via URL parameter to the running application
- Always use a strong password in production environments
- Reload clears all application caches
- Session data may be lost during reload
- Database connections are refreshed
- All singletons are recreated
- The server must be running for this command to work
Common Issues
Section titled “Common Issues”- Invalid password: Check password in settings.cfm
- Server not running: Start server with
box server start - Connection refused: Ensure server is accessible on expected port
- Timeout: Large applications may take time to reload
See Also
Section titled “See Also”- wheels init - Initialize application configuration=
- wheels info - Display application information