Run applications

Last modified: 10 August 2023

You can run applications right from RubyMine. Before you start, make sure to configure a Ruby interpreter for your project.

Quick way

Run from the editor

If you are not going to pass any parameters to your program, and your program does not require any specific actions to be performed before start, you can run it right from the editor.

  • To run a script, open it in the editor or select it in the Project tool window, and then select Run <script file name> from the context menu.

    Run a script

  • To run a test, click the gutter icon next to it or press . The gutter icon changes depending on the state of your test, see Performing tests.

Run the current file

You can run single files using a dedicated option on the toolbar. The run and debug buttons are active and allow you to instantly run the currently opened file.

  1. In the editor, open the file that you want to run.

  2. Click Run next to the Current File option on the toolbar.

    Running a single file from the toolbar

You can access other runners as well: expand the list and select Current File. From the widget that opens, you can debug the code, run it with coverage, profile it, or open the run configuration to specify more options.

More options for running current file

Customizable way

Use a run/debug configuration

If you are going to pass parameters to your program, add VM options (for example, to allow remote debugging), or otherwise customize the startup of your program, use a run/debug configuration.

Edit and save a temporary configuration, or create a new run/debug configuration from a template and use one of the following options to run it:

  • Click Run from the Run/Debug Configurations dialog.

    Run/debug configuration: the Run button

  • Select the configuration from the toolbar switcher and click The Run button or press.

    Run configuration selector

  • Press and select the configuration on the pop-up window that opens.

When the application starts, you can view its output and interact with it in the Run tool window. Every run/debug configuration creates a separate tab when you run it.

tip

Use the shortcut to search for text occurrences in the console output.

To learn more about tool windows and how to manage them, see the Tool windows topic.

Re-run applications

tip

If you re-run an application, the output of the previous run is lost. To preserve the output of an application, click the Pin Tab button on the toolbar of the Run tool window. When a tab is pinned, new sessions are opened in another tab.

Stop and pause applications

When you stop a program, its process is interrupted and exits immediately. When you pause a program, it continues running in the background, but its output is suspended.

Stop a program

  • In the Run tool window, click the Stop button on the toolbar. Alternatively, press and select the process to stop.

Pause the program output

  • Right-click in the Run tool window and select Pause Output from the context menu. Use the same toggle to resume the program.

note

Only the output is suspended. Pausing the output does not affect the execution of the program.

Show running processes

You can view the list of all active run or debug sessions and navigate between them.

See also

Reference

Concepts