Homebrew Portable Ruby

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

How do I install these formulae

Just brew install homebrew/portable-ruby/<formula>.

How do I build packages for these formulae

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.

macOS

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

Linux

Build a Docker image for your architecture by running:

• docker build -f Dockerfile --platform linux/amd64 -t homebrew-portable .

Build the portable-ruby package using that Docker image.

docker run --name=homebrew-portable-ruby -w /bottle homebrew-portable brew portable-package ruby
docker cp homebrew-portable-ruby:/bottle .

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/homebrew/portable-ruby

And to GitHub releases:

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

where $VERSION is the new package version.

Current Status

Used in production for Homebrew/brew.

License

Code is under the BSD 2 Clause (NetBSD) license.