Running Local Development Servers

Beginner Tutorial: Hello World

Beginner Tutorial: Hello Database

Tutorial: Wheels, AJAX, and You

Frameworks and Wheels

Requirements

Manual Installation

Upgrading

Screencasts

CLI Overview

Quick Start Guide

wheels info

wheels reload

wheels deps

wheels destroy

wheels watch

wheels generate app

wheels generate app-wizard

wheels generate controller

wheels generate model

wheels generate view

wheels generate property

wheels generate route

wheels generate resource

wheels generate api-resource

wheels generate frontend

wheels generate test

wheels generate snippets

wheels scaffold

wheels db create

wheels db drop

wheels db setup

wheels db reset

wheels db status

wheels db version

wheels db rollback

wheels db seed

wheels db dump

wheels db restore

wheels db shell

wheels db schema

wheels dbmigrate info

wheels dbmigrate latest

wheels dbmigrate up

wheels dbmigrate down

wheels dbmigrate reset

wheels dbmigrate exec

wheels dbmigrate create blank

wheels dbmigrate create table

wheels dbmigrate create column

wheels dbmigrate remove table

wheels test

wheels test run

wheels test coverage

wheels test debug

wheels config list

wheels config set

wheels config env

wheels env

wheels env setup

wheels env list

wheels env switch

wheels environment

wheels console

wheels runner

wheels server

wheels server start

wheels server stop

wheels server restart

wheels server status

wheels server log

wheels server open

wheels plugins

wheels plugins list

wheels plugins install

wheels plugins remove

wheels analyze

wheels analyze code

wheels analyze performance

wheels analyze security

wheels security

wheels security scan

wheels optimize

wheels optimize performance

wheels docs

wheels docs generate

wheels docs serve

wheels ci init

wheels docker init

wheels docker deploy

wheels deploy

wheels deploy audit

wheels deploy exec

wheels deploy hooks

wheels deploy init

wheels deploy lock

wheels deploy logs

wheels deploy proxy

wheels deploy push

wheels deploy rollback

wheels deploy secrets

wheels deploy setup

wheels deploy status

wheels deploy stop

Configuration Management

Creating Commands

Service Architecture

Migrations Guide

Testing Guide

Conventions

Configuration and Defaults

Directory Structure

Switching Environments

Testing Your Application

Using the Test Environment

Contributing to Wheels

Submitting Pull Requests

Documenting your Code

Request Handling

Rendering Content

Redirecting Users

Sending Files

Sending Email

Responding with Multiple Formats

Using the Flash

Using Filters

Verification

Event Handlers

Routing

Apache

IIS

Tomcat

Nginx

Obfuscating URLs

Caching

Nesting Controllers

CORS Requests

Pages

Partials

Linking Pages

Layouts

Form Helpers and Showing Errors

Displaying Links for Pagination

Date, Media, and Text Helpers

Creating Custom View Helpers

Localization

Object Relational Mapping

Creating Records

Reading Records

Updating Records

Deleting Records

Column Statistics

Dynamic Finders

Getting Paginated Data

Associations

Nested Properties

Object Validation

Object Callbacks

Calculated Properties

Transactions

Dirty Records

Soft Delete

Automatic Time Stamps

Migrations in Production

Using Multiple Data Sources

Installing and Using Plugins

Developing Plugins

Publishing Plugins

Overview

Source Code

Issue Tracker

Sponsor Us

Community
Ask or search...
Ctrl K

wheels reload

Reload the Wheels application in different modes.

Synopsis

wheels reload [options]
wheels r [options]

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

| Argument | Description | Default | |----------|-------------|---------| | mode | Reload mode: development, testing, maintenance, production | development | | password | Required - The reload password configured in your application | None |

Options

| Option | Description | |--------|-------------| | --help | Show help information |

Reload Modes

Development Mode

wheels reload password=mypassword
  • Enables debugging
  • Shows detailed error messages
  • Disables caching
  • Ideal for active development

Testing Mode

wheels reload mode=testing password=mypassword
  • Optimized for running tests
  • Consistent environment
  • Predictable caching

Maintenance Mode

wheels reload mode=maintenance password=mypassword
  • Shows maintenance page to users
  • Allows admin access
  • Useful for deployments

Production Mode

wheels reload mode=production password=mypassword
  • Full caching enabled
  • Minimal error information
  • Optimized performance

Examples

Basic reload (development mode)

wheels reload password=wheels

Reload in production mode

wheels reload mode=production password=mySecretPassword

Using the alias

wheels r password=wheels

Reload for testing

wheels reload mode=testing password=wheels

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

Configuration

Set the reload password in your Wheels settings.cfm:

set(reloadPassword="mySecretPassword");

Notes

  • 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

  • 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