rubylang/ruby repository overview

⁠rubylang/ruby

Official Ruby Docker images maintained by the Ruby core team.

• Docker Hub: https://hub.docker.com/r/rubylang/ruby/⁠
• GitHub Container Registry: https://github.com/ruby/docker-images/pkgs/container/ruby⁠
• Source: https://github.com/ruby/docker-images⁠

⁠Quick start

Pull the latest stable Ruby image and run it:

docker pull rubylang/ruby:4.0
docker run --rm rubylang/ruby:4.0 ruby -v

The latest tag points to the most recent stable release of the current latest series (4.0).

⁠What is this?

This repository provides two flavors of Ruby images for each supported version:

• Production (e.g. rubylang/ruby:4.0-noble): minimal image with Ruby and bundler installed.
• Development (e.g. rubylang/ruby:4.0-dev-noble): based on the production image, with build-essential, gdb, and other development tools added. The -dev suffix follows the version number.

The images listed below are based on Ubuntu noble, resolute, or jammy, and are built by running make install on the official Ruby source tarball. Unsuffixed tags such as rubylang/ruby:4.0 and rubylang/ruby:latest currently track the noble images.

⁠Images

⁠Ubuntu 24.04 (noble)

• master
  • rubylang/ruby:master-noble
  • rubylang/ruby:master-dev-noble
  • rubylang/ruby:master-debug-noble
  • rubylang/ruby:master-debug-dev-noble
• 4.0
  • rubylang/ruby:latest
  • rubylang/ruby:4.0-noble
  • rubylang/ruby:4.0.4-noble
• 3.4
  • rubylang/ruby:3.4-noble
  • rubylang/ruby:3.4.9-noble
• 3.3
  • rubylang/ruby:3.3-noble
  • rubylang/ruby:3.3.11-noble

⁠Ubuntu 26.04 (resolute)

• master
  • rubylang/ruby:master-resolute
  • rubylang/ruby:master-dev-resolute
  • rubylang/ruby:master-debug-resolute
  • rubylang/ruby:master-debug-dev-resolute
• 4.0
  • rubylang/ruby:4.0-resolute
  • rubylang/ruby:4.0.4-resolute
• 3.4
  • rubylang/ruby:3.4-resolute
  • rubylang/ruby:3.4.9-resolute
• 3.3
  • rubylang/ruby:3.3-resolute
  • rubylang/ruby:3.3.11-resolute

⁠Ubuntu 22.04 (jammy)

• master
  • rubylang/ruby:master-jammy
  • rubylang/ruby:master-dev-jammy
  • rubylang/ruby:master-debug-jammy
  • rubylang/ruby:master-debug-dev-jammy
• 4.0
  • rubylang/ruby:4.0-jammy
  • rubylang/ruby:4.0.4-jammy
• 3.4
  • rubylang/ruby:3.4-jammy
  • rubylang/ruby:3.4.9-jammy
• 3.3
  • rubylang/ruby:3.3-jammy
  • rubylang/ruby:3.3.11-jammy

⁠Misc

Additional images are published for special purposes:

• Preview or release-candidate versions (e.g. rubylang/ruby:4.0.0-preview2-noble)
• Nightly builds of master (e.g. rubylang/ruby:master-nightly-noble)
• Nightly debug builds of master (e.g. rubylang/ruby:master-debug-nightly-noble)
• EOL versions, for compatibility use only (e.g. rubylang/ruby:2.4.10-jammy)

⁠Contributing

The Dockerfile and build scripts live in the ruby/docker-images⁠ repository.

⁠Building locally

rake docker:build ruby_version=<Ruby version you want to build>

You can also specify a specific revision on the master branch:

rake docker:build ruby_version=master:ce798d08de

⁠Triggering a build

Builds can be triggered via GitHub Actions workflow_dispatch. Open the Actions tab, select the "Build Docker image with multi-arch" workflow, and run it with a ruby_version parameter (e.g. 3.4.9 or master).

⁠Scheduled builds

Scheduled builds run every 8 hours on GitHub Actions, at 00:15, 08:15, and 16:15 UTC (09:15, 17:15, and 01:15 JST).

⁠Author

Kenta Murata

⁠License

MIT