Set up a Ruby development environment

IntelliJ IDEA supports the reference implementation of Ruby (Ruby MRI) and alternative implementations, such as JRuby or TruffleRuby. Before installing the Ruby interpreter, you need to install the dependencies required to compile Ruby on your machine. For example, depending on your operating system, these dependencies can include the following tools and libraries:

• Ubuntu: build-essential, libssl-dev, etc.

• macOS: xcode-select, openssl, etc.

Depending on the way you've chosen to install Ruby, these libraries can be installed manually or automatically. For example, the Ruby Version Manager (RVM) installs the required libraries automatically while the ruby-build utility requires installing them manually.

tip

Apart from the dependencies mentioned above, you may need to install additional tools for database and JavaScript support.

After installing prerequisite dependencies, you are ready to install the Ruby interpreter to your local machine. There are plenty of options that are described in the Installing Ruby topic. The main ways to install Ruby are:

Version managers

Platforms: macOS, Linux

The most popular way to install Ruby on Linux or macOS is using a version manager, such as RVM, rbenv, chruby, or asdf. Version managers allow you to install several Ruby versions on your machine and quickly switch between them. IntelliJ IDEA automatically detects interpreters installed on a local machine and maintained by version managers.

You can also install Ruby directly from IntelliJ IDEA when you open the existing project. This method requires RVM, rbenv, or asdf installed on your machine. When you open a project that specifies a Ruby version in its configuration files, a notification will appear, allowing you to install the required Ruby version for the project. IntelliJ IDEA will then set the installed interpreter as the default for the current project.

You can learn more from the Ruby version managers topic.

Package managers

Platforms: macOS, Linux

You can install Ruby on Linux or macOS by using the system's package manager. For example, this can be apt or snap for Ubuntu and Homebrew for macOS. Learn how to configure a project interpreter installed in this way from Add a local interpreter.

note

macOS note

Ruby versions 2.0 and later are included by default in macOS since El Capitan (10.11). We don't recommend using this pre-installed Ruby as a project interpreter because you can encounter permission errors while installing dependencies.

Ruby installers

Platforms: macOS, Linux, Windows

You can install Ruby on Linux or macOS by using third-party installers, such as ruby-build or ruby-install. These installers can be used along with version managers to switch between different Ruby versions.

On Windows, you can use RubyInstaller to set up the Ruby environment quickly. If you are planning to develop Rails applications on Windows 10, the Ruby interpreter installed to Windows Subsystem for Linux (WSL) might be a better choice. In IntelliJ IDEA, you can configure the Ruby interpreter installed to WSL.

tip

Apart from the local Ruby environment, IntelliJ IDEA allows you to use remote interpreters, such as Docker, Vagrant, WSL, or SSH. Learn more in Remote development.

The installed Ruby interpreter is supplied with a set of third-party libraries. Most of these libraries are distributed as a gem — a packaged library or application that can be installed with a tool called RubyGems. This tool is bundled with Ruby MRI starting with version 1.9, so most likely, you don't need to install it separately. You can learn more about this tool from the official Ruby documentation.

tip

IntelliJ IDEA provides the ability to display the RubyGems environment for a current project from the main menu by using the Tools | Show Gem Environment command. The invoked dialog shows the RubyGems and Ruby versions, the installation directory, and so forth.

The next important library you need to install to your Ruby interpreter is Bundler. This tool allows you to manage your project dependencies and install exact gems and versions that are needed. These dependencies are specified in a Gemfile, which is placed in a project root directory.

As a rule, the installed Ruby interpreter comes with Bundler installed, but its version can differ from one required for your project. In such cases, IntelliJ IDEA suggests you installing the required version. Learn how IntelliJ IDEA integrates with Bundler from the Bundler topic.

tip

If you have any issues related to installing Bundler, check out the Troubleshooting common issues guide.

To work with Rails projects in the IDE, you need to install the 'rails' gem to the Ruby interpreter. There are several ways to do this in IntelliJ IDEA:

• When creating a new Rails application, you can install the 'rails' gem right from the New Project wizard.

• For existing projects, add the 'rails' gem to your Gemfile and install it using Bundler.

• Open the embedded IntelliJ IDEA terminal emulator and execute the gem install rails command.

When you create a new Rails project, make sure to install Git beforehand. This step is necessary since IntelliJ IDEA automatically creates a local Git repository for all new Rails projects.

note

If you don't want IntelliJ IDEA to create a Git repository, specify the --skip-git Rails option in the New Project dialog.

Rails includes the Active Record framework for Object-Relational Mapping (ORM) - a technique that connects application objects to tables in a relational database management system. The most common database management systems used in Rails are Sqlite, Mysql, and Postgres. To use the desired database system in your project, install a corresponding package to your operating system. For example, to install Postgres on macOS using Homebrew, execute the following command in a terminal:

brew install postgresql

tip

IntelliJ IDEA has database management functionality and allows you to query, create, and manage databases.

Rails applications can contain JavaScript modules managed in the following ways:

• Webpacker: a wrapper gem on Webpack – the popular tool used for managing and bundling JavaScript code.

• Asset Pipeline: a legacy framework for working with JavaScript and CSS assets in Rails.

Note that the Webpacker is a default JavaScript compiler starting with Rails 6. To use Webpacker in your applications, you need to install the following tools:

• Node.js: a JavaScript runtime.

• Yarn: a dependency manager for JavaScript libraries.

After that, you can install JavaScript dependencies right from IntelliJ IDEA and work with your JavaScript code.

Various remote development tools, such as Docker, Vagrant, or Windows Subsystem for Linux (WSL), allow you to use an isolated environment for developing your applications. This can be useful in multiple cases, for example, if you want to:

• Develop in an isolated environment to avoid impacting your local machine configuration.

• Run, debug, and test your application on the same operating system you deploy.

• Develop Linux-deployed applications using the Windows Subsystem for Linux.

You can prepare the desired Ruby/Rails setup in a remote environment using Docker Compose, Vagrant box, or WSL. Then, you can add the remote Ruby interpreter in IntelliJ IDEA and run, debug, and test your application in an isolated environment right from the IDE.