Title: feat: allow overriding the deploy base image per runtime (FIPS / hardened bases) · Issue #5002 · triggerdotdev/trigger.dev · GitHub
Open Graph Title: feat: allow overriding the deploy base image per runtime (FIPS / hardened bases) · Issue #5002 · triggerdotdev/trigger.dev
X Title: feat: allow overriding the deploy base image per runtime (FIPS / hardened bases) · Issue #5002 · triggerdotdev/trigger.dev
Description: Is your feature request related to a problem? Please describe. We self-host Trigger.dev inside a FedRAMP boundary. FedRAMP (NIST SC-13) requires the task runtime to use a FIPS-validated cryptographic module. Stock Node statically links O...
Open Graph Description: Is your feature request related to a problem? Please describe. We self-host Trigger.dev inside a FedRAMP boundary. FedRAMP (NIST SC-13) requires the task runtime to use a FIPS-validated cryptograph...
X Description: Is your feature request related to a problem? Please describe. We self-host Trigger.dev inside a FedRAMP boundary. FedRAMP (NIST SC-13) requires the task runtime to use a FIPS-validated cryptograph...
Opengraph URL: https://github.com/triggerdotdev/trigger.dev/issues/5002
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"feat: allow overriding the deploy base image per runtime (FIPS / hardened bases)","articleBody":"### Is your feature request related to a problem? Please describe.\n\nWe self-host Trigger.dev inside a FedRAMP boundary. FedRAMP (NIST SC-13) requires the task runtime to use a FIPS-validated cryptographic module. Stock Node statically links OpenSSL and can't run in FIPS mode, so this has to be a property of the base image (e.g. Chainguard `node-fips`).\n\nThe deploy image base can't be changed today:\n\n- The base and build images are hard-pinned per runtime in [`BASE_IMAGE`](https://github.com/triggerdotdev/trigger.dev/blob/eb04c3191e3698c3ec4e07fb384c1ed3d9855923/packages/cli-v3/src/deploy/buildImage.ts#L711-L720) and [`BUILD_IMAGE`](https://github.com/triggerdotdev/trigger.dev/blob/eb04c3191e3698c3ec4e07fb384c1ed3d9855923/packages/cli-v3/src/deploy/buildImage.ts#L722-L731).\n- The base is read from that map at [one point](https://github.com/triggerdotdev/trigger.dev/blob/eb04c3191e3698c3ec4e07fb384c1ed3d9855923/packages/cli-v3/src/deploy/buildImage.ts#L818), and the runtime stage is always [`FROM base AS final`](https://github.com/triggerdotdev/trigger.dev/blob/eb04c3191e3698c3ec4e07fb384c1ed3d9855923/packages/cli-v3/src/deploy/buildImage.ts#L1007-L1009).\n- Build extensions can add to the base stage with [`image.instructions` / `image.pkgs`](https://github.com/triggerdotdev/trigger.dev/blob/eb04c3191e3698c3ec4e07fb384c1ed3d9855923/packages/core/src/v3/build/extensions.ts#L60-L67), but they can't replace it.\n\nThe only option today is to `yarn patch` the `BASE_IMAGE` constant in the CLI. That has to be redone on every CLI release.\n\n### Describe the solution you'd like to see\n\nAn opt-in override in `trigger.config.ts`, next to [`build.extensions`](https://github.com/triggerdotdev/trigger.dev/blob/eb04c3191e3698c3ec4e07fb384c1ed3d9855923/packages/core/src/v3/config.ts#L208-L225):\n\n```ts\nexport default defineConfig({\n runtime: \"node-26\",\n build: {\n image: {\n base: \"cgr.dev/acme/node-fips:26@sha256:…\", // runtime (final) stage\n buildBase: \"cgr.dev/acme/node-fips:26-dev@sha256:…\", // optional; defaults to BUILD_IMAGE\n },\n },\n});\n```\n\nAlso accept the same values from build-time env vars, e.g. `TRIGGER_BUILD_BASE_IMAGE` / `TRIGGER_BUILD_BUILD_IMAGE` (with the same precedence as the `TRIGGER_BUILD_SKIP_APT_SNAPSHOT` escape hatch proposed in #4558). Then a platform team can set the base once in CI for every project instead of in each project's config.\n\nIn `generateContainerfile`: `baseImage: env.TRIGGER_BUILD_BASE_IMAGE ?? config.build.image?.base ?? BASE_IMAGE[runtime]`, and the same pattern for `BUILD_IMAGE`. Nothing changes when neither is set.\n\nThe override has to live on the CLI side. The Containerfile is generated and built during `trigger deploy`, and the supervisor only runs the digest it's given, so the webapp and Helm chart have nothing to hook into.\n\nDocument the contract the generated Containerfile already relies on, plus a \"you own this image\" caveat:\n\n1. `node` on `PATH` at the runtime's major version.\n2. The [`DEFAULT_PACKAGES`](https://github.com/triggerdotdev/trigger.dev/blob/eb04c3191e3698c3ec4e07fb384c1ed3d9855923/packages/cli-v3/src/deploy/buildImage.ts#L734): `busybox`, `ca-certificates`, `dumb-init` (the [entrypoint](https://github.com/triggerdotdev/trigger.dev/blob/eb04c3191e3698c3ec4e07fb384c1ed3d9855923/packages/cli-v3/src/deploy/buildImage.ts#L1032)), `git`, `openssl`.\n3. A `node` user, because the final stage runs `USER node`.\n4. glibc, for native modules built in the build stage.\n5. `image.pkgs`, and the extensions that emit `apt-get` (`aptGet`, `playwright`, …), assume Debian. When a custom base is set, the CLI should either reject them with a clear error or leave package installation to the image owner.\n\n### Describe alternate solutions\n\n- **`yarn patch` the `BASE_IMAGE` constant (what we do today).** It works, but every CLI bump needs re-validation, and the digest bumps need their own automation.\n- **Rebase or rewrite the image after push.** Doesn't work: finalize records the digest before anything could change it.\n- **Swap the base with `image.instructions`.** Doesn't work: instructions run inside `FROM base` and can't change what `base` is.\n- **Let users supply the whole Containerfile** (raised as an alternative in #1210). This is far more surface area than a base override, and it would break whenever the generated stages change.\n\n### Additional information\n\n- Related: #1210 (needed a CA-cert injection hook, worked around by patching CLI internals), #4558 / #4581 / #4602 / #4607 (introduced the pinned prebuilt bases this would override), #2911 (Docker Hub rate limits pulling base images).\n- No existing issue covers this. We searched for base image, custom image, Containerfile, FIPS, hardened and Chainguard.\n- **Possible follow-up (not part of this request):** an instance-level policy, set through webapp env / Helm values, that pins or allow-lists the base images deploys to that instance may use, enforced when the deploy is created. That would make \"every task image on this instance is FIPS\" provable from the server side, not only by CI convention.\n- This applies to any regulated self-hoster (FedRAMP, DoD IL, HIPAA/PCI hardening, internal golden images), not just FIPS.\n- Happy to contribute the PR. It looks like one config field plus a two-line fallback in `buildImage.ts`, plus docs.\n\n","author":{"url":"https://github.com/brentshulman-silkline","@type":"Person","name":"brentshulman-silkline"},"datePublished":"2026-10-05T22:12:32Z","url":"https://github.com/triggerdotdev/trigger.dev/issues/5002"}
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react-reconciler,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@d5750093facf |
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:dd509ef6-122f-51f4-2677-358b0922eb56 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | 9A8C:1F642:1309371:1AA2CEB:6AFADE44 |
| html-safe-nonce | c6a26c2c331a302dac0476dc3eabd739d2537bca6c6cb8db9abcf0513110be92 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiI5QThDOjFGNjQyOjEzMDkzNzE6MUFBMkNFQjo2QUZBREU0NCIsInZpc2l0b3JfaWQiOiI1MDAxMjUzNTU1NTYyNzk4NjYwIiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0= |
| visitor-hmac | 58af01614af91d0ae757c843723f4c477ea0acd199b163c3730429e50be2130e |
| hovercard-subject-tag | issue:5719630778 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/triggerdotdev/trigger.dev/5002/issue_layout |
| twitter:image | https://opengraph.githubassets.com/0b8f1c2c873aa0ea931ceeff79a0b844c93ca582f948fee6e354e02e0b226128/triggerdotdev/trigger.dev/issues/5002 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/0b8f1c2c873aa0ea931ceeff79a0b844c93ca582f948fee6e354e02e0b226128/triggerdotdev/trigger.dev/issues/5002 |
| og:image:alt | Is your feature request related to a problem? Please describe. We self-host Trigger.dev inside a FedRAMP boundary. FedRAMP (NIST SC-13) requires the task runtime to use a FIPS-validated cryptograph... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | brentshulman-silkline |
| hostname | github.com |
| expected-hostname | github.com |
| None | 9d9bd51a568909a83d1abb9d6f74d68f0c87ca85fe3a56d3f5d70d8b89add9f2 |
| turbo-cache-control | no-preview |
| go-import | github.com/triggerdotdev/trigger.dev git https://github.com/triggerdotdev/trigger.dev.git |
| octolytics-dimension-user_id | 95297378 |
| octolytics-dimension-user_login | triggerdotdev |
| octolytics-dimension-repository_id | 572570113 |
| octolytics-dimension-repository_nwo | triggerdotdev/trigger.dev |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 572570113 |
| octolytics-dimension-repository_network_root_nwo | triggerdotdev/trigger.dev |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 4a7ae932999cc6d511008dbf980ff9efad2a31f7 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width