# Run Rack applications

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

[Rack](https://github.com/rack/rack) is an interface for developing web applications in Ruby. It provides the API for interaction between web servers and web frameworks. For example, Rails and Sinatra use Rack under the hood for logging, session handling, and so on.

RubyMine provides the dedicated Rack [run/debug configuration](run-debug-configuration.html) for running Rack applications using the rackup tool. For instance, you can specify a server type (for example, [Thin](https://github.com/macournoyer/thin)), IP address and port, and the Rack configuration file.

## Prerequisites

Before running the Rack application, make sure that the following prerequisites are met:

* The 'rack' gem [is installed](using-the-bundler.html) to the project interpreter.

* The required web server gem (for example, 'thin') is installed to the project interpreter.

## Run the Rack application with 'config.ru'

To run the Rack application that uses `config.ru` file, follow the steps below:

Procedure:

1. Open the Project view `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Meta+1` (TextMate), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS)).

2. Right-click the `config.ru` and select Run 'config.ru'.

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

## Create the Rack configuration manually

To create the run/debug configuration for running the Rack application, follow the steps below:

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 Run/Debug Configuration dialog, click ![Add](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Ctrl+N` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Meta+Shift+N` (TextMate), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS)) in the top left corner and select Rack.

3. Specify the following settings:

![Run/Debug Configuration: Rack](https://resources.jetbrains.com/help/img/idea/2026.3/rm_rack_run_config.png)

* Server: Specify a web server for running an application. You might need to install a corresponding gem to the [project interpreter](configuring-language-interpreter.html) (for example, the 'thin' gem for the Thin server).

* IP Address: Specify the IP address where the Rails server will be accessible.

* Port: Specify the port used to run the selected server.

* Rack config file: Specify a path to the Rack configuration file. For example, this can be the `config.ru` file.

* Run browser: Use this option to enable opening an application automatically in a default browser.

* Start JavaScript debugger automatically: Enable this option to [start the JavaScript debugger](debug-javascript-in-a-rails-application.html). Note that JavaScript debugging is available only in [Chrome](debugging-javascript-in-chrome.html) and other browser of the Chrome family.

* Working directory: Specify the working directory used by the running task. For example, this option is in effect when the running script loads other scripts by relative paths.

* Environment variables: Specify the list of [environment variables](https://docs.ruby-lang.org/en/master/ENV.html) as the name-value pairs, separated with semi-colons. Alternatively, click the ellipsis button 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 [Ruby interpreter](configuring-language-interpreter.html) used to run the server. You can choose the project default Ruby interpreter, or select a different one from the list of configured Ruby interpreters.

Click OK to save the created configuration.

## Run the Rack application using a run/debug configuration

You can run the Rack application using the [created configuration](#create_rack_config) 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)).

* 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)).

* 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)).

> **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.

