The rails command line tool is the primary interface for managing Ruby on Rails applications. Developers use it to generate code, run servers, and maintain database integrity.
This overview highlights common tasks, options, and expected behavior when working with Rails projects.
| Category | Command | Purpose | Typical Flags |
|---|---|---|---|
| Server | rails server | Starts the Puma development server | -p, -b, -e |
| Console | rails console | Opens an interactive Ruby environment | sandbox, --environment |
| Database | rails db:migrate | Runs pending database migrations | VERSION, --trace |
| Generators | rails generate | Creates models, controllers, and more | --skip, --pretend |
| Testing | rails test | Runs the test suite | n, verbose, --dry-run |
Starting and Managing the Local Server
Launching the development server is straightforward and often the first command new developers run.
The rails server command starts a single-threaded web server suitable for local development. You can specify the port and binding address to control network access.
Port and Binding Options
Using -p changes the listening port, while -b determines which network interface the server uses. These options help avoid conflicts and control accessibility.
Working with the Rails Console
The console lets you interact with your models, query the database, and test code snippets in real time.
Running rails console opens a persistent session where ActiveRecord is loaded. You can also use rails c as a shorthand for convenience.
Sandbox Mode
Using the sandbox flag rolls back changes when you exit, which is ideal for experimentation without polluting the database.
Database Tasks and Migrations
Managing schema and data safely requires a clear workflow around migrations and structural changes.
The rails db:migrate command applies pending migrations, while rails db:rollback reverts the last batch. Environment selection ensures you work on the correct database.
Schema Loading and Structure
Use rails db:schema:load to set up the database structure without running each migration, which is faster and safer for new setups.
Generating Code with Rails
Generators automate the creation of files, reducing repetitive work and enforcing project conventions.
You can generate models, controllers, views, and jobs with clear, predictable output. Rails also supports skipping tests or assets when they are not needed.
Scaffold and Resource Generators
Scaffold provides a full set of model, views, and controller files, but it is best used for prototyping rather than production code.
Best Practices and Key Takeaways
- Always check migration status before deploying to avoid schema drift.
- Use sandbox mode in the console for testing destructive operations.
- Prefer rails db:schema:load for fresh setups instead of replaying all migrations.
- Leverage short flags like -p and -b to quickly adjust local development behavior.
- Generate only the files you need to keep the project lean and maintainable.
FAQ
Reader questions
How do I start the server on a custom port without changing the default configuration?
Use rails server -p followed by the port number to temporarily bind to a different port without altering config files.
Can I run migrations for a specific environment without modifying database.yml?
Yes, set RAILS_ENV or use the --environment flag with rails db:migrate to target a non-default environment.
What is the safest way to experiment in the console without affecting production data?
Start rails console in sandbox mode so all changes are automatically rolled back when you exit the session.
How can I undo the last migration safely and verify the status afterward?
Run rails db:rollback and then rails db:migrate:status to confirm which migrations are currently applied.