Wheels 4.0

Welcome to Wheels 4.0. These guides teach you the framework from zero — including CFML itself if you're new to the language. Start with whichever door matches your situation:

I'm new to Wheels Orientation, a five-minute install, your first 15 minutes, and a full tutorial that builds a working blog.

I have a 2.x or 3.x app What changed, the version-by-version upgrade guides, and how to upgrade with or without the CLI.

I don't use CLI tooling Install from two zip downloads — fully supported, zero dependencies — and the no-CLI equivalent for every framework task.

I'm a CommandBox shop Keep box for servers and installs. Exactly what's supported, what isn't, and how framework tasks work in your setup.

I'm deploying to my own servers Docker, plain VMs, IIS on Windows — no CLI required — or the built-in wheels deploy if you want zero-downtime shipping.

Not sure which tooling story fits you? Choosing Your Tooling settles it in one page — including a glossary of every tool name these guides mention.

The full map

• Start Here — orientation, installing (three supported paths), first 15 minutes, the blog tutorial.
• Upgrading & Releases — version upgrade guides, release channels, reading the changelog.
• Core Concepts — how Wheels thinks: request lifecycle, MVC, conventions, ORM, DI, middleware, routing, environments.
• The Basics — everyday how-tos: routing, controllers, views, forms, validation, models, associations, migrations, seeding, the query builder.
• Digging Deeper — authentication, jobs, caching, email, uploads, SSE, channels, i18n, multi-tenancy, packages, and more.
• Testing — writing and running model, controller, view, integration, functional, and browser tests.
• Deployment & Operations — production config, security hardening, observability, self-managed deploys, and wheels deploy.
• Contributing & Project — contributing code and docs to Wheels itself.
• wheels CLI Reference — every command, flag by flag.
• Glossary — every Wheels term defined in one place.