A high performance implementation of the Ruby programming language. Built on the GraalVM by Oracle Labs.
TruffleRuby comes in two distributions:
You can install either of those:
RVM: $ rvm install truffleruby rbenv: $ rbenv install truffleruby-VERSION OR truffleruby-dev chruby: $ ruby-install truffleruby $ ruby-build truffleruby-dev ~/.rubies/truffleruby-dev
rbenv: $ rbenv install truffleruby+graalvm-VERSION OR truffleruby+graalvm-dev chruby: $ ruby-install truffleruby-graalvm $ ruby-build truffleruby+graalvm-dev ~/.rubies/truffleruby+graalvm-dev
- uses: ruby/[email protected] with: ruby-version: truffleruby # or truffleruby-head, or truffleruby+graalvm or truffleruby+graalvm-head
You can use
bundle to install gems, as usual.
Please report any issues you might find on GitHub.
TruffleRuby aims to:
There are two main runtime configurations of TruffleRuby, Native and JVM, which have different trade-offs.
|Time to start TruffleRuby||about as fast as MRI startup||slower|
|Time to reach peak performance||faster||slower|
|Peak performance (also considering GC)||good||best|
|Java host interoperability||needs reflection configuration||just works|
To find out which runtime configuration is being used, run
ruby --version on the command line,
or check the value of
TruffleRuby.native? in Ruby code.
Runtime configurations are further detailed in Deploying TruffleRuby.
TruffleRuby is actively tested on the following systems:
arm64): Supported on Linux (from 21.2)
You may find that TruffleRuby will not work if you severely restrict the
environment, for example, by unmounting system filesystems such as
Without these dependencies, many libraries including RubyGems will not work. TruffleRuby will try to print a nice error message if a dependency is missing, but this can only be done on a best effort basis.
You also need to set up a UTF-8 locale if not already done.
See the contributor workflow document if you wish to build TruffleRuby from source.
We recommend that people trying TruffleRuby on their gems and applications get in touch with us for help.
TruffleRuby can run Rails and is compatible with many gems, including C extensions. However, TruffleRuby is not 100% compatible with MRI 3.0 yet. Please report any compatibility issues you might find. TruffleRuby passes around 97% of ruby/spec, more than any other alternative Ruby implementation.
TruffleRuby might not be fast yet on Rails applications and large programs. Notably, large programs currently take a long time to warmup on TruffleRuby and this is something the TruffleRuby team is currently working on. Large programs often involve more performance-critical code so there is a higher chance of hitting an area of TruffleRuby which has not been optimized yet.
TruffleRuby has the same version, and is released at the same time as GraalVM. There is a release every 3 months. See the release roadmap.
TruffleRuby should in most cases work as a drop-in replacement for MRI, but you should read about our compatibility.
For many use cases TruffleRuby should work as a drop-in replacement for JRuby. However, our approach to integration with Java is different to JRuby so you should read our migration guide.
Extensive user documentation is available in
Please report security vulnerabilities via the process outlined in the reporting vulnerabilities guide, rather than by something public such as a GitHub issue or a Gitter conversation.
Announcements about GraalVM, including TruffleRuby, are made on the graal-dev mailing list.
The main authors of TruffleRuby ordered by first contribution are: Chris Seaton, Benoit Daloze, Kevin Menard, Petr Chalupa, Brandon Fish, Duncan MacGregor, Christian Wirth, Rafael França, Alan Wu, Nicolas Laurent, Carol Chen, Nikolay Sverchkov, Lillian Zhang, Tom Stuart, and Maple Ong.
TruffleRuby is copyright (c) 2013-2021 Oracle and/or its affiliates, and is made available to you under the terms of any one of the following three licenses: