Por que hospedar você mesmo o kit de PDF em vez de usar mais um conversor web gratuito

Conversores de PDF que só existem no navegador otimizam upload, clique e download. Os anúncios costumam sustentar a página, e raramente há uma superfície estável para desenvolvedor além do formulário. Esse formato de produto está certo para uma tarefa humana pontual. Ele está errado quando você precisa de automação, de uma política de retenção ou de arquivos que não podem sair da sua rede.

O que os conversores de navegador otimizam

Um conversor público vende conveniência: abrir a aba, largar o arquivo, pegar o resultado, sair. A interface é o produto. Scripts ou raspam o HTML, ou batem em endpoints não documentados que mudam sem aviso. A retenção fica com quem opera o armazenamento temporário. Para um único merge de dois PDFs pessoais, essa troca é razoável.

No momento em que você precisa da mesma tarefa a partir do CI, de um agente ou de uma rede isolada, as peças que faltam aparecem todas juntas: autenticação, OpenAPI, novas tentativas idempotentes e um catálogo que não diverge em silêncio do formulário que você clicou na semana passada.

O que você ganha rodando este catálogo por conta própria

O site hospedado e uma instância self-hosted compartilham as mesmas operações. Comprimir e Mesclar são as mesmas operações, tenha a requisição saído do portal ou de POST /api/v1/…. O self-host acrescenta controle em volta desse catálogo comum:

• REST + OpenAPI em /v1/openapi.json: cada ferramenta do catálogo é um endpoint estável, não apenas um formulário.
• MCP em /mcp: os agentes descobrem e chamam as mesmas operações sem precisar montar raspadores próprios.
• CLI (pdfx): o pdf-core local, ou --cloud apontando para uma chave de API na sua URL base.
• Sem cliente desktop: o caminho offline é o Docker Compose; plugins e instaladores para Windows ficam de fora de propósito.
• Anúncio nenhum na sua pilha: o AdSense do site público não faz parte de uma instalação self-hosted. Os uploads nunca saem das máquinas que você opera.

O Compose sobe o pdfx-server em Rust e o portal em Next.js juntos, para que pessoas e scripts compartilhem um catálogo. O desenvolvimento nativo (task pdfx:dev mais o portal) usa o mesmo caminho de operações. Os detalhes estão em Self-host.

O OCR continua devolvendo Markdown (text/markdown) em /api/v1/misc/ocr-pdf nas duas formas de instalação, e não um PDF pesquisável com a camada refeita. Mudar o servidor de lugar altera onde os bytes ficam; não cria um contrato de operação diferente.

O que deixamos de fora de propósito

Canvas de “editar PDF”, comparação visual, criação de PDF em branco e interfaces de assinatura para consumidor final exigem outro trabalho de produto. Preferimos manter a matriz de ferramentas baseada em formulário e a API. O self-host não destrava uma segunda árvore de interface: ele apenas move a mesma árvore para trás do seu firewall.

Deixar essas superfícies de consumidor de lado é deliberado. Um editor em canvas seria uma segunda base de código, sempre atrasada em relação à OpenAPI. A restrição que importa no uso privado é "os bytes ficam aqui", não "existe um .exe". Sobre a ausência de uma versão desktop, veja Por que não fizemos um aplicativo desktop.

Quando o serviço hospedado basta, e quando não basta

Use o site público quando quiser configuração zero e uma tarefa pontual anônima. As ferramentas do catálogo e as chamadas anônimas a /api/v1/ não pedem conta; as respostas do serviço hospedado trazem cabeçalhos de limite de requisições, e os tetos existem para que a superfície gratuita não vire a fazenda de processamento em lote de outra pessoa (limite de requisições anônimas).

Faça self-host quando regras de retenção, redes privadas ou automação privada exigirem. Nesse caso, disponibilidade, atualização de imagens, disco para arquivos temporários, TLS e rotação de chaves passam a ser sua responsabilidade (SECURITY_CUSTOMGLOBALAPIKEY para uma chave fixa na sua máquina). As operações continuam as mesmas; o que muda é onde os bytes ficam.

Experimente

Comece por Self-host e Desenvolvedores. Para conhecer a superfície de API voltada a agentes em qualquer URL base, leia Feito para agentes de IA, não só para navegadores. Para uma análise mais longa de custo e benefício, veja O que o self-host realmente traz.