ossrules.md

railpack

Configure and troubleshoot Railpack builds, with emphasis on RAILPACK_* environment variables, railpack.json overlays, build-plan inspection, local CLI installation and usage, and local BuildKit containers. Use for Railpack provider configuration, custom install/build/start commands, Mise or Apt packages, build or runtime variables and secrets, generated-plan debugging, BUILDKIT_HOST errors, or running Railpack from a release or source checkout.

Install
npx skills add 'https://github.com/railwayapp/railpack/tree/main/.'
Incomplete bundle · no download
main · 21a254f ↗Scanned 2026-09-17

Contributors

GitHub-linked commit authors for this SKILL.md at the saved revision. Co-authors and history before file renames are not included.

File history ↗

core/__snapshots__/TestGenerateBuildPlanForExamples_ruby-3-precompiled_1.snap.json

core/__snapshots__/TestGenerateBuildPlanForExamples_ruby-3-precompiled_1.snap.jsonBrowse 1970 files
View on GitHub
1,185 tokens

3,587 bytes
Token encoding: o200k_base
Snapshot 21a254f

← Back to SKILL.md
{ "caches": {  "apt": {   "directory": "/var/cache/apt",   "type": "locked"  },  "apt-lists": {   "directory": "/var/lib/apt/lists",   "type": "locked"  } }, "deploy": {  "base": {   "step": "packages:apt:runtime"  },  "inputs": [   {    "include": [     "/mise/shims",     "/mise/installs",     "/usr/local/bin/mise",     "/etc/mise/config.toml",     "/root/.local/state/mise"    ],    "step": "packages:mise"   },   {    "include": [     "/usr/local/bundle"    ],    "step": "install"   },   {    "include": [     "/app"    ],    "step": "build"   }  ],  "startCommand": "ruby --yjit app.rb",  "variables": {   "BUNDLE_GEMFILE": "/app/Gemfile",   "GEM_HOME": "/usr/local/bundle",   "GEM_PATH": "/usr/local/bundle",   "LD_PRELOAD": "libjemalloc.so.2",   "MALLOC_ARENA_MAX": "2",   "RAILPACK_VERSION": "dev"  } }, "steps": [  {   "caches": [    "apt",    "apt-lists"   ],   "commands": [    {     "cmd": "sh -c 'apt-get update \u0026\u0026 apt-get install -y cargo libjemalloc-dev libyaml-dev rustc'",     "customName": "install apt packages: cargo libjemalloc-dev libyaml-dev rustc"    }   ],   "inputs": [    {     "image": "ghcr.io/railwayapp/railpack-builder:mise-2026.9.9"    }   ],   "name": "packages:apt:build"  },  {   "assets": {    "generated-mise-toml": "[generated-mise-toml]"   },   "commands": [    {     "path": "/mise/shims"    },    {     "dest": "mise.toml",     "src": "mise.toml"    },    {     "dest": ".ruby-version",     "src": ".ruby-version"    },    {     "dest": "Gemfile",     "src": "Gemfile"    },    {     "dest": "mise.lock",     "src": "mise.lock"    },    {     "customName": "create mise config",     "name": "generated-mise-toml",     "path": "/etc/mise/config.toml"    },    {     "cmd": "mise install",     "customName": "install mise packages: ruby"    }   ],   "inputs": [    {     "step": "packages:apt:build"    }   ],   "name": "packages:mise",   "variables": {    "MISE_CACHE_DIR": "/mise/cache",    "MISE_CONFIG_DIR": "/mise",    "MISE_DATA_DIR": "/mise",    "MISE_INSTALLS_DIR": "/mise/installs",    "MISE_SHIMS_DIR": "/mise/shims",    "RUBY_CONFIGURE_OPTS": "--disable-install-doc"   }  },  {   "commands": [    {     "cmd": "gem install -N bundler:2.4.9"    },    {     "dest": "Gemfile",     "src": "Gemfile"    },    {     "dest": "Gemfile.lock",     "src": "Gemfile.lock"    },    {     "cmd": "bundle install"    },    {     "path": "/usr/local/bundle"    }   ],   "inputs": [    {     "step": "packages:mise"    }   ],   "name": "install",   "variables": {    "BUNDLE_GEMFILE": "/app/Gemfile",    "GEM_HOME": "/usr/local/bundle",    "GEM_PATH": "/usr/local/bundle",    "LD_PRELOAD": "libjemalloc.so.2",    "MALLOC_ARENA_MAX": "2"   }  },  {   "inputs": [    {     "step": "install"    },    {     "include": [      "."     ],     "local": true    }   ],   "name": "build",   "variables": {    "BUNDLE_GEMFILE": "/app/Gemfile",    "GEM_HOME": "/usr/local/bundle",    "GEM_PATH": "/usr/local/bundle",    "LD_PRELOAD": "libjemalloc.so.2",    "MALLOC_ARENA_MAX": "2"   }  },  {   "caches": [    "apt",    "apt-lists"   ],   "commands": [    {     "cmd": "sh -c 'apt-get update \u0026\u0026 apt-get install -y libjemalloc2 libyaml-dev'",     "customName": "install apt packages: libjemalloc2 libyaml-dev"    }   ],   "inputs": [    {     "image": "ghcr.io/railwayapp/railpack-runtime:mise-2026.9.9"    }   ],   "name": "packages:apt:runtime"  } ]}
← All Railpack skillsProject instructions →