Portable Ruby Binaries

Tools to build versions of Ruby that can be installed and run from anywhere on the filesystem.

How do I use these rubies

These are general-purpose portable Ruby binaries. Download the appropriate tarball for your platform from the releases page and extract it to any location.

SSL certificates

These Rubies use the first available certificate source in this order:

Priority	Source	Paths
1	Standard OpenSSL overrides	SSL_CERT_FILE, SSL_CERT_DIR
2	Portable Ruby overrides	JDX_RUBY_SSL_CERT_FILE, JDX_RUBY_SSL_CERT_DIR
3	Homebrew and Linuxbrew bundles	/opt/homebrew/etc/openssl@3/cert.pem, /usr/local/etc/openssl@3/cert.pem, /opt/homebrew/etc/ca-certificates/cert.pem, /usr/local/etc/ca-certificates/cert.pem, /home/linuxbrew/.linuxbrew/etc/openssl@3/cert.pem, /home/linuxbrew/.linuxbrew/etc/ca-certificates/cert.pem
4	System bundles	/etc/ssl/certs/ca-certificates.crt, /etc/pki/tls/certs/ca-bundle.crt, /etc/ssl/ca-bundle.pem, /etc/ssl/cert.pem
5	Bundled CA bundle	Last-resort fallback included with the portable build.

Local development

• Run bin/setup to tap your checkout of this repo as jdx/ruby.
• Run e.g. brew jdx-package --no-uninstall-deps --debug --verbose jdx-ruby@3.4.5 to build Ruby 3.4.5 locally with YJIT.

How do I issue a new release

An automated release workflow is available to use. Dispatch the workflow and all steps of building, tagging and uploading should be handled automatically.

Manual steps are documented below.

Build

Run brew portable-package ruby. For macOS, this should ideally be inside an OS X 10.11 VM (so it is compatible with all working Homebrew macOS versions).

Upload

Copy the bottle bottle*.tar.gz and bottle*.json files into a directory on your local machine.

Upload these files to GitHub Packages with:

brew pr-upload --upload-only --root-url=https://ghcr.io/v2/jdx/ruby

And to GitHub releases:

brew pr-upload --upload-only --root-url=https://github.com/jdx/ruby/releases/download/$VERSION

where $VERSION is the new package version.

Thanks

Forked from spinel-coop/rv-ruby, which was based on Homebrew/homebrew-portable-ruby.

License

Code is under the BSD 2-Clause "Simplified" License.