rvm-windows

Unofficial reimplementation of most important rvm.io features for MS Windows

As there is no rvm.io available for native windows, but only for POSIX by Cygwin, this is a reimplementation of basic rvm.io features for native MS Windows on the classic command line. It is based on the packages shipped by rubyinstaller.org.

RVM 4 Windows allows you to comfortably install and manage several versions of Ruby on your Windows machine.

It automatically detects .ruby-version files or ruby version definitions in Gemfiles and runs your project on the classic windows command line on the specified ruby version automatically.

Beneath you can switch your ruby version instantly.

Ruby environments are managed by RVM per user.

- Pre beta. Only for test purpose.

Missing basic features or known bugs:
- rvm uninstall 
- rvm upgrade
- automatic "ridk install 1" and "ridk install 3" after installing a ruby environment (?)
- define/set default version 
- rvm use system
- rvm reinstall <version>
- check if 'cd' wrapper does make sense on windows to detect rubies on directory change

The goal of this project is not to 100% reimplement all features of rvm.io, but the most important and common ones by preserving most of the same command line interface. Some special Windows related stuff will be added as well.

Table of contents

• Usage
• Installation
• Troubleshooting
• Contributing

Commands

The following commands are or will be available in rvm-windows:

add <path>        # Add a installed ruby environment to the list
config            # Print current RVM config
current           # Print current ruby version
fix               # Automatically fix paths and versions in RVM configuration
help              # Print this usage guide
init              # Initialize RVM by adding to PATH environment variable
install           # Install a specific ruby version
kit               # (experimental, instable) Install x64 dependencies to build native gems like postgresql, mysql2, ...
list              # List all installed ruby versions managed by RVM
list verbose      # List all installable ruby versions with additional info
list known        # List all installable ruby versions
scan              # Scan for ruby installations and add them to the RVM configuration
update            # Check for RVM updates
use               # Switch to specified ruby version
version           # Display build version

Usage

Usage examples

List installed rubies

rvm list

 * ruby-3.2.2
   ruby-2.4.10
=> ruby-2.7.8


# => - current
# =* - current && default
#  * - default

List installable rubies

rvm list known

 - ruby-3.3.0
 - ruby-3.2.3
 - ruby-3.2.2
 - ruby-3.2.1
 - ruby-3.2.0
 - ruby-3.1.4
...
 - ruby-3.0.2
 - ruby-3.0.1
 - ruby-3.0.0
 - ruby-2.7.8
 - ruby-2.7.7
 - ruby-2.7.6
 - ruby-2.7.5
...
 - ruby-2.5.1
 - ruby-2.4.10
 - ruby-2.4.9
...
 - ruby-2.4.4
 - ruby-2.4.4

Switch version

You do not need to prefix ruby-

rvm use 2.4.10

Using ruby-2.4.10 ...

You even do not need to specify the exact version, it will automatically use or install the highest one available!

rvm use 2

Using ruby-2.7.8 ...

Install new version

rvm install 3.2

Installing ruby-3.2.3 ...
...

Installation

You can either use npm or yarn to install rvm-windows.

After install the command rvm is available on the command line.

On your command line execute the following command:

yarn

yarn global add rvm-windows

npm

npm install -g rvm-windows

Troubleshooting

Does not run the selected ruby

Check if in your system wide PATH setting some ruby environment is listed and remove it from the system PATH variable.

Otherwise try

rvm init

or

rvm fix

again.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/magynhard/rvm-windows. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.