Get Started

This is a short guide on how to install Ringo on your system. The only essential requirement is the Java Platform, Standard Edition.
The oldest supported release is Java SE 5. We recommend Java SE 7 or higher to run Ringo. You can download Java from:

Installing Ringo

Download the latest Ringo release

This is the recommended and straight forward way to install Ringo. Download the latest precompiled release from the
download page. For convinience, you should add the /bin directory to the PATH environment variable.

Hombrew on Mac OS X

If you use the 🍺Homebrew package manager, you can use the ringojs formula:

brew install ringojs

Starting the Ringo shell

If you added Ringo to your PATH variable, run ringo without arguments:

$ ringo

This should start a shell session with a >> prompt. Use the include, require, or import functions to load any RingoJS module.