# Run Rails applications

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/help/ruby/2026.3/llms.txt).

> **TL;DR**
> Run a selected configuration: `Run | Run` `Shift+F10` (Windows), `⌃ R` (macOS), `⇧ F10` (IntelliJ IDEA Classic (macOS)), `⌥ ⇧ R` (macOS System Shortcuts), `Shift+F10` (XWin), `Shift+F10` (GNOME), `Shift+F10` (KDE), `Shift+F10` (Emacs), `Shift+F10` (Sublime Text), `Shift+F10` (Sublime Text (macOS)), `Ctrl+F5` (Visual Studio), `⌃ F5` (Visual Studio (macOS)), `Meta+Ctrl+R` (TextMate), `F6` (NetBeans), `Alt+Shift+X` (Eclipse), `⌘ ⇧ F11` (Eclipse (macOS))
>
>
>
> Select a configuration before running: `Run | Run...` `Alt+Shift+F10` (Windows), `⌃ ⌥ R` (macOS), `⌥ ⇧ F10` (IntelliJ IDEA Classic (macOS)), `⌃ ⌥ R` (macOS System Shortcuts), `Alt+Shift+F10` (XWin), `Alt+Shift+F10` (GNOME), `Alt+Shift+F10` (KDE), `Alt+Shift+F10` (Emacs), `Alt+Shift+F10` (Sublime Text), `⌃ ⌥ R` (Sublime Text (macOS)), `Ctrl+Alt+Shift+R` (Visual Studio), `⌘ ⌥ ⇧ R` (Visual Studio (macOS)), `Meta+R` (TextMate), `Alt+Shift+F10` (NetBeans), `Alt+Shift+F10` (Eclipse), `⌃ ⌥ R` (Eclipse (macOS))

RubyMine allows you to run or debug Rails applications by using the configured set of startup parameters - [run/debug configurations](run-debug-configuration.html). For instance, you can specify the following parameters for the Rails run/debug configuration: a server type (such as Puma or Passenger), IP address and port, environment (development by default), and so on.

Note that for Rails projects, RubyMine automatically creates the development run/debug configuration with the corresponding [Rails
environment](https://guides.rubyonrails.org/configuring.html#creating-rails-environments). You can always set up your own run/debug configurations for other Rails environments.

## Run the Rails server without configuring

To run the Rails server for the first time without any configuring, do the following:

Procedure:

1. Press `Ctrl` (Windows), `Ctrl` (macOS), `Ctrl` (IntelliJ IDEA Classic (macOS)), `Ctrl` (macOS System Shortcuts), `Ctrl` (XWin), `Ctrl` (GNOME), `Ctrl` (KDE), `Ctrl` (Emacs), `Ctrl` (Sublime Text), `Ctrl` (Sublime Text (macOS)), `Ctrl` (Visual Studio), `Ctrl` (Visual Studio (macOS)), `Ctrl` (TextMate), `Ctrl` (NetBeans), `Ctrl` (Eclipse), `Ctrl` (Eclipse (macOS)) twice.

2. Type the `rails server` command in the invoked popup and press `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (TextMate), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS)).

3. Wait until RubyMine starts the Rails server. The Run tool window shows the application's output.

![Run tool window / run Rails application](https://resources.jetbrains.com/help/img/idea/2026.3/rm_get_started_run_app_output.png)

After you've run the Rails server, RubyMine automatically creates a special profile - a temporary [run/debug configuration](run-debug-configuration.html). You can [customize settings](#rails_run_config) of this configuration, for example, a server type, IP address and port, environment, and so on. Then, you can [save](run-debug-configuration.html#save-as-permanent) the customized configuration to quickly [run this configuration](#run_with_config) in the future.

## Run the Rails server using a run/debug configuration

You can run the Rails server with the existing [run/debug configurations](run-debug-configuration.html) in one of the following ways:

Procedure:

* Press `Ctrl` (Windows), `Ctrl` (macOS), `Ctrl` (IntelliJ IDEA Classic (macOS)), `Ctrl` (macOS System Shortcuts), `Ctrl` (XWin), `Ctrl` (GNOME), `Ctrl` (KDE), `Ctrl` (Emacs), `Ctrl` (Sublime Text), `Ctrl` (Sublime Text (macOS)), `Ctrl` (Visual Studio), `Ctrl` (Visual Studio (macOS)), `Ctrl` (TextMate), `Ctrl` (NetBeans), `Ctrl` (Eclipse), `Ctrl` (Eclipse (macOS)) twice to invoke the Run Anything popup. Start typing the required configuration name, select it from the list, and press `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (TextMate), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS)).

![Run Anything / run configuration](https://resources.jetbrains.com/help/img/idea/2026.3/rm_get_started_run_any_run_config.png)

* Select the desired configuration on the toolbar and click ![Run](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.execute.svg) `Shift+F10` (Windows), `⌃ R` (macOS), `⇧ F10` (IntelliJ IDEA Classic (macOS)), `⌥ ⇧ R` (macOS System Shortcuts), `Shift+F10` (XWin), `Shift+F10` (GNOME), `Shift+F10` (KDE), `Shift+F10` (Emacs), `Shift+F10` (Sublime Text), `Shift+F10` (Sublime Text (macOS)), `Ctrl+F5` (Visual Studio), `⌃ F5` (Visual Studio (macOS)), `Meta+Ctrl+R` (TextMate), `F6` (NetBeans), `Alt+Shift+X` (Eclipse), `⌘ ⇧ F11` (Eclipse (macOS)).

![Run selected configuration](https://resources.jetbrains.com/help/img/idea/2026.3/rm_run_code_config_toolbar.png)

* Go to `Run | Run...` `Alt+Shift+F10` (Windows), `⌃ ⌥ R` (macOS), `⌥ ⇧ F10` (IntelliJ IDEA Classic (macOS)), `⌃ ⌥ R` (macOS System Shortcuts), `Alt+Shift+F10` (XWin), `Alt+Shift+F10` (GNOME), `Alt+Shift+F10` (KDE), `Alt+Shift+F10` (Emacs), `Alt+Shift+F10` (Sublime Text), `⌃ ⌥ R` (Sublime Text (macOS)), `Ctrl+Alt+Shift+R` (Visual Studio), `⌘ ⌥ ⇧ R` (Visual Studio (macOS)), `Meta+R` (TextMate), `Alt+Shift+F10` (NetBeans), `Alt+Shift+F10` (Eclipse), `⌃ ⌥ R` (Eclipse (macOS)) and select the desired configuration from the list and press `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (TextMate), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS)).

![Select run configuration](https://resources.jetbrains.com/help/img/idea/2026.3/rm_run_code_config_popup.png)

> **Tip:**
> You can also use the [Services tool window](services-tool-window.html#run-configs) to manage multiple run/debug configurations at once in a dedicated tool window.

## Configure Rails server parameters

When you run the Rails server [for the first time](#run_without_config), RubyMine automatically creates a corresponding Rails [temporary configuration](run-debug-configuration.html#temp_config), which can be saved. If necessary, you can create the Rails run/debug configuration [manually](run-debug-configuration.html#createExplicitly) from the predefined template.

To customize the run/debug configuration, do the following:

Procedure:

1. Open the Run/Debug Configuration dialog in one of the following ways:

* Select `Run | Edit Configurations` from the main menu.

* With the [Navigation bar](guided-tour-around-the-user-interface.html#navigation-bar) visible (`View | Appearance | Navigation Bar`), choose `Edit Configurations` from the run/debug configuration selector. ![Edit run configurations](https://resources.jetbrains.com/help/img/idea/2026.3/rm_open_run_config_from_navigation_bar.png)

* Press `Alt+Shift+F10` (Windows), `⌃ ⌥ R` (macOS), `⌥ ⇧ F10` (IntelliJ IDEA Classic (macOS)), `⌃ ⌥ R` (macOS System Shortcuts), `Alt+Shift+F10` (XWin), `Alt+Shift+F10` (GNOME), `Alt+Shift+F10` (KDE), `Alt+Shift+F10` (Emacs), `Alt+Shift+F10` (Sublime Text), `⌃ ⌥ R` (Sublime Text (macOS)), `Ctrl+Alt+Shift+R` (Visual Studio), `⌘ ⌥ ⇧ R` (Visual Studio (macOS)), `Meta+R` (TextMate), `Alt+Shift+F10` (NetBeans), `Alt+Shift+F10` (Eclipse), `⌃ ⌥ R` (Eclipse (macOS)) and then press `0` (Windows), `0` (macOS), `0` (IntelliJ IDEA Classic (macOS)), `0` (macOS System Shortcuts), `0` (XWin), `0` (GNOME), `0` (KDE), `0` (Emacs), `0` (Sublime Text), `0` (Sublime Text (macOS)), `0` (Visual Studio), `0` (Visual Studio (macOS)), `0` (TextMate), `0` (NetBeans), `0` (Eclipse), `0` (Eclipse (macOS)).

2. In the opened Run/Debug Configurations dialog, select the required configuration in the Rails group, and specify its settings.

![Run/Debug Configurations: Rails](https://resources.jetbrains.com/help/img/idea/2026.3/rm_run_debug_configuration_rails.png)

## Run/debug configuration: Rails

### Configuration tab

| Item | Description |
| --- | --- |
| Server |    Specify a web server for running a Rails application. You might need to install a corresponding gem to the project interpreter (for example, `Puma`, `Passenger`, and so on). You can find the full list of supported Rails servers here: [Supported technology versions](supported-ruby-versions.html#supported_rais_servers).      |
| IP Address |    Specify the IP address where the Rails server will be accessible.      If you use Puma with unix socket binding for running your application, it is not required to specify the IP address of the server. If the value is not provided, RubyMine will omit the `-b <IP Address>` option when running the `rails server` command.     If the IP address is not provided, the [browser preview](editing-html-files.html) of HTML and ERB files is not available.    |
| Port | Specify the port to run the Rails server.      If you use Puma with unix socket binding for running your application, it is not required to specify the port of the server. If the value is not provided, RubyMine will omit the `-b <IP Address>` option when running the `rails server` command.     If the port is not provided, the [browser preview](editing-html-files.html) of HTML and ERB files is not available.    |
| Server arguments | Type optional server arguments. You can run the `rails server --help` command in the [terminal emulator](terminal-emulator.html) to learn more about available arguments. |
| Environment | Select the required Rails environment to run the server (`development`, `production`, or `test`). |
| Dummy app | This field is only enabled for the [Rails mountable engine                             projects](working-with-rails-mountable-engine-projects.html) . Specify the absolute path to the `dummy` directory. This path is required to run the engine.  |
| Run browser | Select this option to enable opening an application automatically in a default browser.     If you enable the option, provide a browser URL to ensure that RubyMine will not run the JS debugger.    |
| Start JavaScript debugger automatically when debugging |    Enable this option to [start the JavaScript debugger](debug-javascript-in-a-rails-application.html).     > **Warning:** > Debugging of JavaScript code is only supported in [Google Chrome](http://www.google.com/chrome/) and in other [Chromium-based browsers](https://www.chromium.org/).    |
| Environment variables |    Specify the list of environment variables as the name-value pairs, separated with semi-colons. Alternatively, click ![the Browse button](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg) to create variables and specify their values in the Environment Variables dialog.       |
| Ruby arguments |    Specify the [command-line arguments](https://ruby-doc.com/docs/ProgrammingRuby/html/rubyworld.html) to be passed to the Ruby interpreter.                 |
| Ruby interpreter | Specify the desired Ruby interpreter. You can choose the project default Ruby interpreter, or select a different one from the list of configured Ruby interpreters.  |

