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 · 21a254fScanned 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_secrets_1.snap.json

core/__snapshots__/TestGenerateBuildPlanForExamples_secrets_1.snap.jsonBrowse 1970 files
View on GitHub
← Back to SKILL.md
{ "deploy": {  "base": {   "image": "ghcr.io/railwayapp/railpack-runtime:mise-2026.9.9"  },  "inputs": [   {    "include": [     "."    ],    "step": "defaultsToUsing"   },   {    "include": [     "."    ],    "step": "usesSecrets"   }  ],  "startCommand": "./run.sh",  "variables": {   "RAILPACK_VERSION": "dev"  } }, "secrets": [  "MY_SECRET",  "MY_OTHER_SECRET",  "HELLO_WORLD" ], "steps": [  {   "inputs": [    {     "image": "ghcr.io/railwayapp/railpack-builder:mise-2026.9.9"    }   ],   "name": "packages:mise"  },  {   "commands": [    {     "dest": ".",     "src": "."    },    {     "cmd": "sh -c './run.sh'",     "customName": "./run.sh"    }   ],   "inputs": [    {     "step": "packages:mise"    }   ],   "name": "defaultsToUsing",   "secrets": [    "*"   ],   "variables": {    "NOT_SECRET": "not secret"   }  },  {   "commands": [    {     "dest": ".",     "src": "."    },    {     "cmd": "sh -c './run.sh'",     "customName": "./run.sh"    }   ],   "inputs": [    {     "step": "packages:mise"    }   ],   "name": "usesSecrets",   "secrets": [    "MY_SECRET",    "MY_OTHER_SECRET"   ],   "variables": {    "NOT_SECRET": "not secret"   }  } ]}