Skip to content

ConductorAI/gotenberg

 
 

Repository files navigation

Gotenberg Logo

Gotenberg

A Docker-powered stateless API for PDF files

Total downloads (gotenberg/gotenberg) Total downloads (thecodingmachine/gotenberg)
Continuous Integration Go Reference Code coverage

Documentation · Live Demo 🔥


Gotenberg provides a developer-friendly API to interact with powerful tools like Chromium and LibreOffice for converting numerous document formats (HTML, Markdown, Word, Excel, etc.) into PDF files, and more!

ConductorAI

This is a fork of the Gotenberg repo designed the minimize the number of vulnerabilities. We do this by removing the Chromium module (which was not needed for our particular use-case) and by building a distroless image.

In order to build and push an updated image, follow these steps

  1. Check https://go.dev/dl/ for the latest GOLANG_VERSION
  2. Check https://fonts.google.com/noto/specimen/Noto+Color+Emoji for the latest NOTO_COLOR_EMOJI_VERSION
  3. Check https://gitlab.com/pdftk-java/pdftk/-/releases for the latest PDFTK_VERSION
  4. Update those respective build arguments in scripts/release.sh
  5. Then run
    bash script/release.sh <URL> <tag>
    

Quick Start

Open a terminal and run the following command:

docker run --rm -p 3000:3000 gotenberg/gotenberg:8

Alternatively, using the historic Docker repository from our sponsor TheCodingMachine:

docker run --rm -p 3000:3000 thecodingmachine/gotenberg:8

The API is now available on your host at http://localhost:3000.

Head to the documentation to learn how to interact with it 🚀

Sponsors

TheCodingMachine Logo Zolsec Logo

Sponsorships help maintaining and improving Gotenberg - become a sponsor ❤️

About

Resources

License

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Go 96.3%
  • Dockerfile 1.8%
  • Makefile 1.4%
  • Shell 0.5%