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

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 --root-url=https://ghcr.io/v2/homebrew/portable-ruby

This will create a bottle commit. Open a PR and merge this into master.

Once the commit is in master, create a new GitHub tag with:

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.