gotenberg/gotenberg

O que é?

Recursos principais

• 01Converte HTML, URLs e Markdown em PDF usando o Chromium em modo headless.
• 02Converte documentos do Office em PDF pelo LibreOffice, com suporte a mais de 100 formatos.
• 03Mescla, divide, gira e achata PDFs.
• 04Adiciona marcas d’água ou carimbos e criptografa PDFs.
• 05Gera arquivos compatíveis com PDF/A e PDF/UA.
• 06Faz capturas de tela de URLs e HTML.

Casos de uso

• Gerar faturas ou relatórios no servidor a partir de modelos HTML.
• Converter arquivos do Word ou Excel enviados por usuários em PDF em uma aplicação web.
• Arquivar páginas da web como PDFs para fins de conformidade ou registro.
• Mesclar PDFs e adicionar marcas d’água em um pipeline automatizado de documentos.

Início rápido

1. 1

   Inicie o contêiner do Gotenberg na porta 3000

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

   Converta uma URL em PDF com uma solicitação POST

   curl \ --request POST http://localhost:3000/forms/chromium/convert/url \ --form url=https://sparksuite.github.io/simple-html-invoice-template/ \ -o invoice.pdf

Antes de usar

• !É necessário ter o Docker para executar o serviço.
• !As conversões dependem do Chromium e do LibreOffice incluídos na imagem, que por isso é grande e consome muitos recursos.

Em coleções

Tópicos

Perguntas frequentes

O que é gotenberg?

Uma API baseada em Docker que converte HTML, URLs, Markdown e documentos do Office em PDF, além de mesclar, dividir e adicionar marcas d’água a PDFs. Gotenberg é uma API HTTP baseada em Docker para converter documentos em PDF. Você envia arquivos ou URLs via multipart/form-data e recebe um PDF em resposta, sem precisar instalar e manter o Chromium, o LibreOffice ou fontes por conta própria.

gotenberg é gratuito? Qual é a licença?

gotenberg é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

gotenberg ainda é mantido?

Manutenção ativa. O último commit de gotenberg foi em 6 de nov. de 2026.

Para que posso usar gotenberg?

Gerar faturas ou relatórios no servidor a partir de modelos HTML. Converter arquivos do Word ou Excel enviados por usuários em PDF em uma aplicação web. Arquivar páginas da web como PDFs para fins de conformidade ou registro. Mesclar PDFs e adicionar marcas d’água em um pipeline automatizado de documentos.

Como instalar gotenberg?

Inicie o contêiner do Gotenberg na porta 3000: docker run --rm -p 3000:3000 gotenberg/gotenberg:8 Converta uma URL em PDF com uma solicitação POST: curl \ --request POST http://localhost:3000/forms/chromium/convert/url \ --form url=https://sparksuite.github.io/simple-html-invoice-template/ \ -o invoice.pdf

Onde consigo gotenberg?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/gotenberg/gotenberg