gotenberg-fips

Echo's FIPS-validated Gotenberg image — the document conversion API for PDFs, built on FIPS 140-3 validated cryptography for FedRAMP and US government workloads.

gotenberg-fips, gotenberg, fips 140-3, fedramp, document conversion API

What is Gotenberg FIPS?

Gotenberg is a Docker-powered stateless API for converting HTML, Markdown, and office documents into PDFs and merging or manipulating them. Teams call it from applications that generate reports and invoices.

The Gotenberg FIPS image is Echo's FIPS variant of Gotenberg: the same document conversion API, built to run on FIPS 140-3 validated cryptography. It is designed for organizations that sell to or operate for the US government — FedRAMP-authorized services, federal contractors, and regulated industries — where a document conversion API that processes documents that often contain sensitive data must use cryptographic modules with an active NIST CMVP certificate, not merely FIPS-enabled libraries.

What is Echo's Gotenberg FIPS image?

Echo's Gotenberg FIPS image is a hardened, FIPS-validated build of Gotenberg on Echo's hardened base. Because Gotenberg is written in Go, its cryptography is handled by a CMVP-validated Go crypto module such as BoringCrypto rather than by OpenSSL; Echo supports OpenSSL, BoringCrypto, and Bouncy Castle across its FIPS images. Echo images are designed to be a drop-in replacement: swap the image reference in your Dockerfile or deployment manifest for the gotenberg-fips image and CVEs go to zero without disrupting your configuration, data volumes, and the clients that connect to it. Every image is tested across clouds, image use cases, and deployment targets. Echo ships every image in two variants:

  • Distroless variant — optimized for runtime use, with the smallest possible attack surface
  • Default variant — includes essential build tools, package managers, and shells for teams that need operational access

For production Gotenberg deployments, the distroless variant keeps all runtime operations — document conversion, PDF merging, and API requests — fully intact while minimizing exposure; the default variant suits operators and platform teams that need shell access for inspecting configuration, diagnosing issues, or running administrative commands.

What is the difference between Echo's Gotenberg FIPS image and the public Gotenberg image?

Public Gotenberg images ship on general-purpose bases whose cryptographic libraries have not been validated under FIPS 140-3, and FIPS-enabled is not the same as FIPS-validated — auditors for FedRAMP and other federal frameworks flag the gap. Those bases also include OS-level tooling convenient for development but which contribute CVEs that accumulate on a document conversion API used in production. Gotenberg images run continuously with access to the content of documents being converted. OS-level CVEs in the base image — particularly in libraries such as openssl, zlib, and libc — create exploitable paths that bypass application-layer controls entirely, allowing attackers to move from a network-reachable service to host-level access. For teams running Gotenberg across many environments, the image is also a steady source of scanner noise in the CI pipeline — every package in the base becomes a finding your security team must triage, even when none of it is reachable from the service. Echo's FIPS build retains everything Gotenberg needs for document conversion, PDF merging, and API requests while routing cryptography through a validated module and removing the packages that don't belong in a production Gotenberg document conversion API. As we covered in our post on how to protect your company from software supply chain attacks, long-running services that hold sensitive data and listen on the network are among the widest attack surfaces in the container stack. Echo commits to a 7-day SLA for critical and high severity vulnerabilities, and 10 days for medium, low, and unknown — with vulnerabilities triaged within 24 hours. Echo FIPS images are STIG-hardened, ship with SBOMs in SPDX and CycloneDX formats and signed provenance, and are recognized by all major scanners and mirrored to all major registries, so they fit into existing pipelines without changing your registry, scanner, or runtime tooling.

FAQ

Can I replace my Gotenberg image with Echo's Gotenberg FIPS image?

Yes. Echo's Gotenberg FIPS image is a drop-in replacement. Update the FROM line in your Dockerfile to the gotenberg-fips image and your workloads keep running. Configuration, data volumes, mounted secrets, and existing client connections all continue to work without changes. Because FIPS mode disallows non-approved algorithms, anything that depends on legacy ciphers or hashes such as MD5-based signatures needs to move to approved algorithms.

Is Echo's Gotenberg FIPS image FIPS-validated?

Yes. Echo's FIPS images use CMVP-validated cryptographic modules, operating in a configuration consistent with the module's FIPS 140-3 security policy. Because Gotenberg is written in Go, its cryptography is handled by a CMVP-validated Go crypto module such as BoringCrypto rather than by OpenSSL; Echo supports OpenSSL, BoringCrypto, and Bouncy Castle across its FIPS images. That makes the image fit for federal use — unlike FIPS-enabled or FIPS-compliant images whose cryptographic libraries have never been validated. This matters for teams running Gotenberg inside FedRAMP boundaries, where a document conversion API that processes documents that often contain sensitive data must meet cryptographic requirements across the full stack. Echo also provides a FIPS runtime tester that executes approved and unapproved algorithms to show how the image behaves at runtime.

What is Echo's vulnerability management SLA on the Gotenberg FIPS image?

Echo commits to a 7-day SLA for critical and high severity vulnerabilities, and 10 days for medium, low, and unknown — with vulnerabilities triaged within 24 hours. Patches are mirrored automatically into your private registry so you're always running a clean version — critical for a long-running service that holds the content of documents being converted and is reachable over the network.

Is Echo's Gotenberg FIPS image distroless?

Echo ships every image in two variants: a distroless variant optimized for runtime use, and a default variant that includes essential build tools, package managers, and shells. For production Gotenberg deployments, the distroless variant is the leaner, more secure choice; for operators and platform teams that need shell access for inspecting configuration, diagnosing issues, or running administrative commands, the default variant is the right fit.

How does Echo achieve such a drastic CVE reduction in Gotenberg?

Echo's Gotenberg FIPS image is built from source with only the absolute essentials needed to run the Gotenberg document conversion API, which significantly shrinks the attack surface. Echo also patches aggressively over time, with backports available so you can stay on the Gotenberg version your applications and their dependencies are certified against — avoiding a disruptive upgrade forced purely by OS-level vulnerabilities in the base image rather than by your own requirements.

Will Echo's Gotenberg FIPS image help us achieve FedRAMP?

Yes. The hard parts of FedRAMP — managing vulnerabilities, applying fixes, and using FIPS-validated cryptography — are baked into Echo images, including STIG-hardened configuration and ConMon/POA&M-ready reporting. For federal agencies, contractors, and FedRAMP-authorized providers running Gotenberg under an ATO — whether that's a FedRAMP-authorized SaaS boundary, a DoD enclave, or an agency-operated platform — Echo's FIPS-validated Gotenberg image keeps the document conversion API layer in-boundary and compliant without requiring custom hardening scripts or manual base image patching between compliance cycles.

‍

Interested in base images that start and stay clean?