Skip to content

About

Self-contained Portable Ruby ( 2.6.10 -> 3.4.x ) Binaries for Linux/MacOS/Windows x64/arm64

Resources

Stars

57 stars

Watchers

0 watching

Forks

Repository files navigation

Traveling Ruby

Self-contained, portable Ruby binaries for Linux (glibc and musl), macOS and Windows, on x86_64 and arm64.

Bundle one with your Ruby app and ship a single package that runs without your users installing Ruby or any gems. A packaged app runs only the Ruby it ships with and never loads the user's own Ruby, gems or RUBYLIB.

Platforms

Traveling Ruby builds Ruby 3.3.13, 3.4.12 and 4.0.9. Each Ruby version and target has its own release, such as ruby-3.4.12-0-linux-x86_64.

Platform Package name Architectures Runs on
Linux (glibc) linux x86_64, arm64 glibc 2.17 or later (CentOS 7, Ubuntu 14.04, Debian 8 and newer)
Linux (musl) linux-musl x86_64, arm64 musl 1.2.2 or later (Alpine 3.15 and newer)
macOS macos x86_64, arm64 macOS 12.2 or later
Windows windows x86_64, arm64 Windows 10 or later; arm64 needs Windows 11 and Ruby 3.4 or later

On Alpine, Ruby itself needs nothing extra, but gems with C++ extensions need libgcc_s, which Alpine doesn't install by default. These are charlock_holmes, eventmachine, mysql2 and unf_ext. Without it they fail to load with Error loading shared library libgcc_s.so.1. To use them, run apk add libgcc.

Releases are tagged ruby-<ruby>-<revision>-<platform>-<arch> and hold traveling-ruby-<ruby>-<revision>-<platform>-<arch>.tar.gz. The revision starts at 0 and goes up only when the runtime itself is rebuilt. The -full packages also contain the prebuilt native extension gems, which are published one gem per tarball as well. New gem versions are added to the existing release, and older ones are never removed. Every release has a SHA256SUMS file, a manifest.json listing its runtime and gems, and a build provenance attestation.

Quickstart

curl -fsSL https://raw.githubusercontent.com/trubygems/traveling-ruby/main/cli.sh | sh
~/.travelling-ruby/bin/ruby --version

On GitHub Actions:

- uses: trubygems/traveling-ruby@main
- run: ruby --version

Documentation

History

This project is a fork of phusion/traveling-ruby, which is no longer maintained. We maintain it for the Pact project, whose users run Ruby tools without installing Ruby. Pact now has replacement tooling in Rust, but we keep Traveling Ruby going, as automated as we can make it.

Thanks to Phusion and Hongli Lai for their work, and on behalf of the many Ruby developers who have shipped their apps with it.

About

Self-contained Portable Ruby ( 2.6.10 -> 3.4.x ) Binaries for Linux/MacOS/Windows x64/arm64

Resources

Stars

57 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages