Railpack

Providers

Fixed

• Node (pnpm): Railpack now sets PNPM_HOME to /opt/pnpm and PNPM_STORE_DIR to /opt/pnpm/store during every pnpm install so BuildKit caches the store path pnpm actually uses. This fixes missed install cache hits when newer pnpm versions write outside the old hardcoded store location. by @iloveitaly in https://github.com/railwayapp/railpack/pull/569

CLI

Fixed

• Config: Custom runtime images set via deploy.base in railpack.json are now applied to the generated deploy step. Previously Railpack parsed deploy.base but did not use it when building the final image; configured bases are used as the deploy filesystem and as the input for runtime apt package layers when those are enabled. by @radiantjade in https://github.com/railwayapp/railpack/pull/561

• Mise: Builds no longer fail when mise.lock pins a tool version newer than the default 14-day minimum release age while your config requests latest. Host-side version resolution applies the age filter first, then falls back when a pinned lockfile version would otherwise be excluded. by @iloveitaly in https://github.com/railwayapp/railpack/pull/575

Internal improvements to CI and GitHub Actions maintenance by @iloveitaly.

Full Changelog: https://github.com/railwayapp/railpack/compare/v0.25.0...v0.26.0

Providers

New

• Node: Railpack now detects and builds projects that use package.json5 manifests (in addition to package.json), including workspace and dependency parsing. If both files exist, package.json takes precedence. by @iloveitaly in https://github.com/railwayapp/railpack/pull/566

• Node: Node 25+ apps that use Corepack (for example packageManager: "pnpm@...") now include the mise install and shim directories in the runtime image, so package managers like pnpm remain available when your start command runs after the build. by @iloveitaly in https://github.com/railwayapp/railpack/pull/568

Fixed

• Node: engines.pnpm in your manifest now takes precedence over pnpm version inferred from pnpm-lock.yaml, avoiding ambiguous lockfile version mapping across major pnpm releases. See package and version resolution for how Railpack resolves tool versions. by @iloveitaly in https://github.com/railwayapp/railpack/pull/566

CLI

New

• Config: The provider field in railpack.json is now listed in the generated JSON schema (railpack schema), with the same values documented in the config file guide. Provider names are matched case-insensitively, so lowercase values like elixir and dotnet work as documented. by @radiantjade in https://github.com/railwayapp/railpack/pull/558

• Mise: Updated mise version from v2026.5.16 to v2026.5.18.

Full Changelog: https://github.com/railwayapp/railpack/compare/v0.24.0...v0.25.0

Internal snapshot maintenance by @iloveitaly.

Providers

New

• Node: Package manager versions for pnpm, bun, and yarn defined in mise config (mise.toml, .tool-versions, etc.) now take priority over versions inferred from lockfiles or project metadata. Pin a version in your config—for example pnpm = "10.4.1" in mise.toml—and Railpack will use it consistently across the build. See Node.js versions and Mise configuration. by @iloveitaly in https://github.com/railwayapp/railpack/pull/564

Fixed

• Node: Builds using pnpm 11+ now add PNPM_HOME/bin to PATH, matching pnpm’s new layout so global tools like node-gyp install and run correctly. by @iloveitaly in https://github.com/railwayapp/railpack/pull/564

• Ruby: Ruby source builds no longer install rdoc, avoiding locale-related compile failures during mise install. by @iloveitaly in https://github.com/railwayapp/railpack/pull/564

• Elixir: Elixir provider environment variables (locale, MIX_ENV, MIX_HOME, etc.) are now applied to the mise install step so Erlang and Elixir install with the same settings as the rest of the build. by @iloveitaly in https://github.com/railwayapp/railpack/pull/564

• Python: Projects using Poetry, PDM, or Pipenv via pipx now also install uv, which newer mise requires when pipx.uvx is enabled. by @iloveitaly in https://github.com/railwayapp/railpack/pull/564

CLI

New

• Mise: Updated mise version from v2026.3.17 to v2026.5.16.

Fixed

• Mise: Generated /etc/mise/config.toml now sets minimum_release_age instead of the renamed install_before setting, matching current mise behavior. Override it in your own mise configuration if needed. by @iloveitaly in https://github.com/railwayapp/railpack/pull/564

Full Changelog: https://github.com/railwayapp/railpack/compare/v0.23.0...v0.24.0

Internal improvements to testing, snapshots, examples, development tooling, and documentation by @iloveitaly and @abdulrahman1s.

Providers

New

• Staticfile: Added a configurable index fallback to the Staticfile provider, allowing users to toggle SPA-style routing for their applications. by @iloveitaly in https://github.com/railwayapp/railpack/pull/534 To enable SPA routing, add index_fallback: true to your Staticfile configuration to have non-existent paths served by index.html.

CLI

New

• Mise: Updated mise version from v2026.3.15 to v2026.3.17. in https://github.com/railwayapp/railpack/pull/539
• Mise: Introduced a new installation policy that defaults to tool versions released at least 14 days ago to avoid broken or incomplete tool versions. by @iloveitaly in https://github.com/railwayapp/railpack/pull/540 This setting improves stability for runtime environments like Python and Ruby by allowing upstream releases time to stabilize before they are used in production builds.
• Verbose Mode: Added support for the RAILPACK_VERBOSE environment variable to enable verbose logging and improved debug logs for mise execution. by @iloveitaly in https://github.com/railwayapp/railpack/pull/536 Set RAILPACK_VERBOSE=1 to enable detailed debug output, including the full command string and captured output from mise during execution.

Fixed

• Configuration: Improved root directory detection by trimming whitespace from environment variables and configuration values. by @iloveitaly in https://github.com/railwayapp/railpack/pull/534

Internal improvements to testing and documentation by @iloveitaly.

Full Changelog: https://github.com/railwayapp/railpack/compare/v0.22.2...v0.23.0

CLI

New

• Mise: Updated mise version from v2026.3.13 to v2026.3.15. in https://github.com/railwayapp/railpack/pull/532

Full Changelog: https://github.com/railwayapp/railpack/compare/v0.22.1...v0.22.2

Internal improvements to documentation by @iloveitaly.

CLI

New

• Mise: Updated mise version from v2026.3.12 to v2026.3.13.

Internal improvements to testing, documentation, and refactoring by @iloveitaly.

Full Changelog: https://github.com/railwayapp/railpack/compare/v0.22.0...v0.22.1

CLI

New

• Configuration: Railpack now uses a global mise.toml to store default tool configurations instead of environment variables, allowing users to naturally override defaults via their project's local mise.toml file. This change makes it easier to customize tool versions and settings without needing to manage complex environment variables. For example, you can now add a [settings] section to your project's mise.toml to specify exact settings that Railpack should use. by @iloveitaly in https://github.com/railwayapp/railpack/pull/504
• Mise: Updated mise version from v2026.3.10 to v2026.3.12.

Internal improvements by @iloveitaly.

Full Changelog: https://github.com/railwayapp/railpack/compare/v0.21.0...v0.22.0

What's Changed

• fix: expose shell completion subcommand by @iloveitaly in https://github.com/railwayapp/railpack/pull/520
• test: add arm builds by @iloveitaly in https://github.com/railwayapp/railpack/pull/509
• feat: additional mise config and idiomatic version files enabling precompiled ruby support by @iloveitaly in https://github.com/railwayapp/railpack/pull/487
• chore: mise update 2026.3.10 by @github-actions[bot] in https://github.com/railwayapp/railpack/pull/522

Full Changelog: https://github.com/railwayapp/railpack/compare/v0.20.0...v0.21.0

Providers

CLI

New

• BuildKit: Images and build cache are now exported in parallel, significantly reducing the time spent in the final stages of the build process. This feature utilizes the latest BuildKit v0.28.0 capabilities and is enabled automatically for all railpack build operations. by @iloveitaly in https://github.com/railwayapp/railpack/pull/515
• Shell: Added native support for Fish shell completion. You can generate the completion script for your shell by running railpack completion fish and adding it to your fish configuration. by @iloveitaly in https://github.com/railwayapp/railpack/pull/515
• toml 1.1 features are supported. This could have caused errors in the past if railpack read a toml file with previously unsupported features

Fixed

• Mise: Updated the internal environment variable to MISE_SYSTEM_CONFIG_DIR to ensure better compatibility and isolation from host configurations when running railpack. by @iloveitaly in https://github.com/railwayapp/railpack/pull/517

Internal improvements to testing, build tooling, and code style by @iloveitaly.

Full Changelog: https://github.com/railwayapp/railpack/compare/v0.19.0...v0.20.0

Providers

New

• Mise Updated mise version from v2026.2.14 to v2026.3.9.
• Node.js: Node.js projects using Bun now support bunfig.toml during the installation step. This ensures custom registries and install behaviors are correctly applied when running bun install. by @iloveitaly in https://github.com/railwayapp/railpack/pull/477
• Ruby: Upgraded to jemalloc2 for Ruby projects to resolve errors on ARM architecture and improve memory performance. This is enabled by default. by @iloveitaly in https://github.com/railwayapp/railpack/pull/338
• Python: Added documentation and an example for using compiled Python as an escape hatch when pre-built binaries are not available for specific versions. This allows developers to use specific Python builds by opting into compilation during the build process. by @iloveitaly in https://github.com/railwayapp/railpack/pull/503

Fixed

• Ruby: Default Ruby versions are now pinned to the minor version instead of a specific patch to allow for automatic security updates and better compatibility with pre-built binaries. by @iloveitaly in https://github.com/railwayapp/railpack/pull/488
• Staticfile: Switched to a binary installer for Caddy to achieve smaller image sizes for static site deployments. by @iloveitaly in https://github.com/railwayapp/railpack/pull/478

CLI

Fixed

• CLI: The CLI now issues a warning if no start command is detected during the build process, providing clearer feedback on potentially missing configuration. by @iloveitaly in https://github.com/railwayapp/railpack/pull/490

Internal improvements to testing, documentation, and refactoring by @iloveitaly

Full Changelog: https://github.com/railwayapp/railpack/compare/v0.18.0...v0.19.0

This is mostly an internal release to ensure that the mise version used in the planning, building, and runtime images are all in sync.

The only user-facing change in this release in bumping the build and runtime mise version to 2026.2.22.

Full Changelog: https://github.com/railwayapp/railpack/compare/v0.17.2...v0.18.0

What's Changed

• chore: mise update 2026.1.12 by @iloveitaly in https://github.com/railwayapp/railpack/pull/451
• fix: eliminate additional logs when using --dump-llb by @iloveitaly in https://github.com/railwayapp/railpack/pull/452
• feat(python): Scan nested dependency files in usesDep by @half0wl in https://github.com/railwayapp/railpack/pull/457

New Contributors

• @half0wl made their first contribution in https://github.com/railwayapp/railpack/pull/457

Full Changelog: https://github.com/railwayapp/railpack/compare/v0.17.1...v0.17.2

What's Changed

• fix: revert playwright support by @iloveitaly in https://github.com/railwayapp/railpack/pull/447

Full Changelog: https://github.com/railwayapp/railpack/compare/v0.17.0...v0.17.1

Providers

New

• Node & Python: We've added automatic Playwright support for Node.js and Python projects. Railpack now detects Playwright dependencies and automatically installs the required system packages and browsers. by @iloveitaly in https://github.com/railwayapp/railpack/pull/348
• Shell: The shell provider now supports a mise install phase, allowing you to define tools to install before your script runs. by @iloveitaly in https://github.com/railwayapp/railpack/pull/433

Fixed

• Node: Consistent Node version resolution is now used when Bun is the package manager. by @iloveitaly in https://github.com/railwayapp/railpack/pull/359
• Node: Trailing whitespace in the packageManager field of package.json is now handled correctly. by @iloveitaly in https://github.com/railwayapp/railpack/pull/432
• Node: Improved detection of version files (like .nvmrc) using Mise's idiomatic parsing. by @iloveitaly in https://github.com/railwayapp/railpack/pull/431
• Python: Builds are now faster for projects using psycopg-binary as unnecessary system dependencies (libpq-dev) are skipped. by @iloveitaly in https://github.com/railwayapp/railpack/pull/379
• Python: .python-version files are now reliably detected in all environments. by @iloveitaly in https://github.com/railwayapp/railpack/pull/378

CLI

Fixed

• Dockerignore: Negation rules (e.g., !file) in .dockerignore now work correctly even if the referenced file does not exist locally. by @iloveitaly in https://github.com/railwayapp/railpack/pull/437
• Config: The provider field is no longer required in railpack.json. by @iloveitaly in https://github.com/railwayapp/railpack/pull/436

Internal improvements to testing, documentation, and refactoring by @iloveitaly and @luojiyin.

Full Changelog: https://github.com/railwayapp/railpack/compare/v0.16.0...v0.17.0

Providers

New

• Python: Projects with start.py or bot.py are now automatically detected as Python apps. This simplifies configuration for simple scripts and bots (e.g. Discord bot that don't have manifest files. by @coffee-cup in https://github.com/railwayapp/railpack/pull/416

Fixed

• Dotnet: The web server now correctly listens on the port defined by the PORT environment variable. See the updated documentation. by @iloveitaly in https://github.com/railwayapp/railpack/pull/401

CLI

Fixed

• Build: Generated Docker image names are now forced to lowercase to prevent build errors with registries that require lowercase repositories. by @iloveitaly in https://github.com/railwayapp/railpack/pull/410

Internal improvements to documentation and build configuration by @iloveitaly, @antonkesy and @Delavalom.

Full Changelog: https://github.com/railwayapp/railpack/compare/v0.15.3...v0.15.4

Providers

Fixed

• Dotnet: set aspnet content root to properly find configuration files by @iloveitaly and @Mohs9n in https://github.com/railwayapp/railpack/pull/396
• Erlang: There is an underlying bug in mise that causes the version selection to break. This has been fixed within Railpack and an upstream change has been submitted to mise.

Internal improvements to testing, documentation, and build tooling by @iloveitaly and @salim-b.

Full Changelog: https://github.com/railwayapp/railpack/compare/v0.15.2...v0.15.3

What's Changed

• sync mise version between Go code and Dockerfile by @coffee-cup in https://github.com/railwayapp/railpack/pull/394

Full Changelog: https://github.com/railwayapp/railpack/compare/v0.15.2...v0.15.3

What's Changed

• update mise veresions by @coffee-cup in https://github.com/railwayapp/railpack/pull/389
• build mise image faster by @coffee-cup in https://github.com/railwayapp/railpack/pull/390
• release build mise for now by @coffee-cup in https://github.com/railwayapp/railpack/pull/391
• install mise from script by @coffee-cup in https://github.com/railwayapp/railpack/pull/392
• fix builder mise location by @coffee-cup in https://github.com/railwayapp/railpack/pull/393

Full Changelog: https://github.com/railwayapp/railpack/compare/v0.15.1...v0.15.2

What's Changed

• perf: optimize plan command for large monorepos by @coffee-cup in https://github.com/railwayapp/railpack/pull/382
• fix: deduplicate deploy inputs when using --build-cmd by @coffee-cup in https://github.com/railwayapp/railpack/pull/381

Full Changelog: https://github.com/railwayapp/railpack/compare/v0.15.0...v0.15.1

What's Changed

• chore: mise update 2025.11.8 by @iloveitaly in https://github.com/railwayapp/railpack/pull/377
• fix: consider exclude patterns when determining LLB merge eligibility by @coffee-cup in https://github.com/railwayapp/railpack/pull/380

Full Changelog: https://github.com/railwayapp/railpack/compare/v0.14.0...v0.15.0