O que o self-host realmente traz (e quanto custa)
Hospedar você mesmo o PDF123 mantém os uploads no seu pdfx-server e expõe o mesmo catálogo REST, MCP e CLI, mas a operação passa a ser sua.
Um conversor público é otimizado para tarefas pontuais e anônimas. Hospedar o PDF123 por conta própria muda o contrato: os uploads chegam a máquinas que você opera, e cada ferramenta do catálogo fica acessível por HTTP, não só como formulário no navegador.
O que você ganha
Localidade dos dados é a primeira aquisição. Os arquivos chegam ao seu pdfx-server, não a um armazenamento temporário que você não administra. A segunda é a superfície de desenvolvedor na mesma máquina: REST sob /api/v1/…, OpenAPI em /v1/openapi.json, MCP em /mcp e pdfx --cloud apontado para a sua URL base.
O Docker Compose roda o backend em Rust e o portal em Next.js juntos, para que pessoas e scripts compartilhem um catálogo. Não existe instalador de desktop nesse caminho; o uso offline é Compose e CLI (Self-host). O desenvolvimento local nativo usa task pdfx:dev ao lado do portal; no Compose são task docker:build / task docker:up (API na :8080, portal na :3000).
Um agente ou uma tarefa de CI com a sua chave chama as mesmas operações do site público. Mesclar, Comprimir, OCR, converter e o resto mantêm os mesmos caminhos e parâmetros. Essa igualdade é o produto, não um slogan.
Os anúncios que financiam o site público não fazem parte de uma instalação self-hosted. Você também sai da história de cota anônima do serviço hospedado: o planejamento de capacidade passa a ser seu, incluindo picos de CPU durante OCR ou mesclagens grandes. O OCR continua devolvendo Markdown (text/markdown) na sua máquina; mudar o servidor de lugar não altera o contrato da operação.
O que custa
Disponibilidade, atualização de imagens, disco para arquivos temporários, TLS e rotação de chaves passam a ser responsabilidade sua. O Compose sobe rápido; mantê-lo saudável é trabalho contínuo. Defina SECURITY_CUSTOMGLOBALAPIKEY quando quiser uma chave de API fixa na sua instância. Recursos opcionais (por exemplo, URL→PDF via SYSTEM_ENABLEURLTOPDF=true) são opções que você habilita de propósito, não padrões que aparecem só porque o site público os tem.
O self-host não adiciona um canvas visual de "editar PDF" só por ligar uma opção. A superfície continua sendo ferramentas de formulário mais API. Se você precisa de edição em canvas, ainda precisa de outro produto; mudar o servidor de lugar não inventa essa interface.
Os limites de requisição e a medição de uso seguem a forma como você configura a máquina. Não suponha que os cabeçalhos e limites anunciados pelo site público se transfiram sem mudança; leia os cabeçalhos que a sua instância devolve quando o orçamento importar. Operações que dependem de componentes extras (modelos de OCR, conversores opcionais) falham com códigos de problema estruturados missing_dependency / unavailable se o binário ou o pacote de modelo não estiver instalado na sua imagem.
Como isso se relaciona com o site público
Use o PDF123 hospedado para testes sem configuração. As ferramentas do catálogo e as chamadas anônimas a /api/v1/ não exigem conta; as respostas trazem X-RateLimit-* e as respostas 429 incluem Retry-After (limite de requisições anônimas).
Faça self-host quando regras de retenção, redes isoladas ou automação privada exigirem. O /llms.txt ajuda os agentes a descobrir ferramentas em qualquer URL base que você rode; o Google Search não o trata como sinal de posicionamento. MCP e OpenAPI continuam disponíveis ao lado do portal nessa mesma base.
Quando ainda não vale fazer self-host
Se você só precisa de uma mesclagem hoje à tarde, o formulário hospedado basta. Se você precisa de bytes privados amanhã e em todos os dias seguintes, comece pelo Compose agora, em vez de encaixar um instalador de desktop num hábito de SaaS. O caminho offline que oferecemos está documentado em Self-host, não numa listagem de loja.
Comece por Self-host. Chaves e OpenAPI ficam em Desenvolvedores. Para um contraste mais curto com conversores que só rodam no navegador, veja Por que hospedar você mesmo o kit de PDF. Para entender por que o Compose é o caminho privado em vez de um .exe, veja Por que não fizemos um aplicativo desktop.