Skip to content

Recent Ruby versions aren't yet supported #27779

@aldur

Description

@aldur

Existing documentation URL(s)

https://developers.cloudflare.com/pages/configuration/build-image/#supported-languages-and-tools

What changes are you suggesting?

The docs state the following:

Under Supported versions, "Any version" refers to support for all versions of the language or tool including versions newer than the Default version.

The following Ruby versions (and their associated release date) are newer than the default version 3.4.4 and aren't yet supported on the platform:

Ruby 3.4.8 2025-12-17
Ruby 3.4.7 2025-10-07
Ruby 3.4.6 2025-09-16
Ruby 3.4.5 2025-07-15

Trying to use them by setting .ruby-version results in the following error:

08:24:04.528 Detected the following tools from environment: ruby@3.4.5
08:24:04.529 Installing ruby 3.4.5
08:24:04.743 Version not found
08:24:04.743
08:24:04.743 If this is a new Ruby version, you may need to update the plugin:
08:24:04.744 asdf plugin update ruby
08:24:04.751 Error: Exit with error code: 1
08:24:04.751     at ChildProcess.<anonymous> (/snapshot/dist/run-build.js)
08:24:04.751     at Object.onceWrapper (node:events:652:26)
08:24:04.751     at ChildProcess.emit (node:events:537:28)
08:24:04.751     at ChildProcess._handle.onexit (node:internal/child_process:291:12)
08:24:04.760 Failed: build command exited with code: 1
08:24:05.924 Failed: error occurred while running build command

Here (private Cloudflare link) for a run that errored out.

The existing documentation is confusing and surprising to users, who expect any version to be supported. It would perhaps be better to provide the exact list of supported versions.

Additional information

No response

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions