Railpack

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

Providers

New

• C/C++: We've added a C/C++ provider supporting CMake and Meson build systems. by @aleksrutins in https://github.com/railwayapp/railpack/pull/319
• Python: We've added automatic start command detection for FastAPI applications using uvicorn. by @iloveitaly in https://github.com/railwayapp/railpack/pull/353

Fixed

• Python: We've fixed detection of psycopg (v3) to ensure required system dependencies (libpq) are installed. by @iloveitaly in https://github.com/railwayapp/railpack/pull/350
• General: We've replaced fuzzy file matching with exact checks to prevent false positives when detecting providers. by @iloveitaly in https://github.com/railwayapp/railpack/pull/347

CLI

Fixed

• General: mise configuration files in the application directory are now automatically trusted, suppressing "untrusted config" warnings. by @iloveitaly in https://github.com/railwayapp/railpack/pull/352

Internal improvements to testing and documentation by @iloveitaly.

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

Providers

New

• Node: Added support for Node.js v25 by ensuring libatomic1 is explicitly installed. by @iloveitaly in https://github.com/railwayapp/railpack/pull/259
• Node: Railpack now ensures Node.js is available during the build phase via mise even when not required for the runtime (e.g. when using Bun), ensuring packages requiring node-gyp build correctly. by @iloveitaly in https://github.com/railwayapp/railpack/pull/259

Fixed

• Node: We've improved how node_modules caching works during the build phase, specifically fixing issues where commands like npm ci (which remove node_modules) caused build failures. See the Node documentation for more details. by @iloveitaly in https://github.com/railwayapp/railpack/pull/259

CLI

New

• Mise: Updated the internal mise version to 2025.11.6. by @iloveitaly in https://github.com/railwayapp/railpack/commit/d249231615dda1f2b4d7ade419f07890e2896079

Fixed

• Mise: Added backoff retries for mise registry downloads to help prevent build failures during intermittent network issues. by @iloveitaly in https://github.com/railwayapp/railpack/pull/360

Internal improvements to testing and maintenance by @iloveitaly.

Full Changelog: https://github.com/railwayapp/railpack/compare/v0.12.0...v0.13.0

Providers

New

• Go: The Go provider now respects the Go version specified in your mise configuration files (e.g., mise.toml, .tool-versions). by @iloveitaly in https://github.com/railwayapp/railpack/pull/300
• Ruby: The Ruby provider now respects the Ruby version specified in your mise configuration files (e.g., mise.toml, .tool-versions). by @iloveitaly in https://github.com/railwayapp/railpack/pull/339
• Node: For Bun projects that require Node.js for build tooling (like node-gyp), Railpack now installs Node.js using mise, respecting versions from .nvmrc, .node-version, and other mise configurations. by @iloveitaly in https://github.com/railwayapp/railpack/pull/341
• Gleam: You can now include your project's source code in the final image by setting the RAILPACK_GLEAM_INCLUDE_SOURCE=true environment variable. by @iloveitaly in https://github.com/railwayapp/railpack/pull/318

Fixed

• Python: The Python provider now configures pipx to use uv for installing packages, resulting in faster dependency installation. by @iloveitaly in https://github.com/railwayapp/railpack/pull/324
• All: Railpack now parses mise configuration files (like mise.toml and .tool-versions) more idiomatically, improving compatibility and correctness. by @iloveitaly in https://github.com/railwayapp/railpack/pull/344

CLI

New

• Caching: You can now disable specific caches during the build process by setting the RAILPACK_DISABLE_CACHE environment variable. For example, to disable the apt and pip caches, set RAILPACK_DISABLE_CACHE="apt,pip". To disable all caches, set it to *. by @aleksrutins in https://github.com/railwayapp/railpack/pull/316

Fixed

• Security: Railpack now enables mise's "paranoid mode" by default, a security feature that requires explicit user consent before installing new tools or running code from project-specific configurations. by @iloveitaly in https://github.com/railwayapp/railpack/pull/336

Internal improvements to documentation, and tooling by @iloveitaly and @aleksrutins.

Full Changelog: https://github.com/railwayapp/railpack/compare/v0.11.0...v0.12.0