Como instalar o Stirling-PDF no Saplo (ferramentas PDF sem enviar documentos para fora)

Fatura para dividir em páginas, digitalização de contrato para compressão antes de enviar por email, documento antigo para passar pelo OCR antes de ir para o arquivo. Cada uma destas tarefas tem o seu serviço gratuito na internet, mas todos eles implicam carregar o documento para um servidor externo e possuem limitações no plano gratuito (limite de tamanho do ficheiro, limite de operações diárias, marca de água no resultado). O Stirling-PDF resolve isto como um único contentor Docker no teu próprio Box: as mesmas operações, sem enviar nada para fora e sem contar quantas vezes usaste a ferramenta hoje. Neste guia mostramos como instalar o Stirling-PDF no Saplo.

O que é o Stirling-PDF e para quem é indicado

O Stirling-PDF é uma ferramenta para PDF auto-hospedada que funciona no navegador, baseada na imagem oficial Docker stirlingtools/stirling-pdf. Num só lugar tens mais de cinquenta operações disponíveis: juntar e dividir ficheiros, converter PDF para Word, Excel ou imagem e vice-versa, compressão, OCR para páginas digitalizadas, assinatura, remoção de palavra-passe e muito mais. É especialmente útil para:

• escritórios que todos os dias juntam, dividem ou comprimem digitalizações e faturas em PDF,
• qualquer pessoa que queira digitalizar um documento em papel para texto pesquisável (OCR) sem o subir a um serviço externo,
• empresas que precisam de converter PDF para outros formatos e o inverso de forma prática, sem limites diários dos serviços online gratuitos.

Esta é uma área diferente do Documenso, que se foca na assinatura eletrónica de contratos entre partes. O Stirling-PDF concentra-se no trabalho com ficheiros PDF, não na gestão de documentos.

Requisitos

Para instalar o Stirling-PDF na Saplo, precisas de:

• Um Box com Docker ativado (o motor ativa-o automaticamente ao instalar a partir do catálogo, é necessário nesting no contentor, algo que a Saplo já tem por predefinição),
• pelo menos 2 GB de RAM e 5 GB de espaço em disco apenas para a aplicação. Na prática, isto significa o Box L por 136 € por ano: o Box M tem exatamente 2 GB de RAM, que é o que a aplicação requer, sem margem para o sistema e outros processos, por isso o motor Saplo recomenda um plano superior neste caso,
• domínios ou subdomínios *.saploapp.pl incluídos no preço de cada plano, onde será instalado o serviço,
• não precisas de uma base de dados separada, pois o Stirling-PDF não mantém uma biblioteca permanente de documentos: os ficheiros entram, são processados e saem, nada fica guardado de forma permanente.

Depois de instalada no Box L, ficam disponíveis 3,8 GB de RAM e 50 GB de disco, o que permite instalar até 137 outras aplicações do catálogo, como o Vaultwarden ou o Excalidraw.

Instalação passo a passo

1. No painel Saplo, acede a Catálogo de aplicações e escolhe Stirling-PDF (categoria "Negócios").
2. Seleciona o Box L ou superior e o domínio ou subdomínio onde a ferramenta irá funcionar.
3. Confirma a instalação. O motor cria um contentor a partir da imagem oficial stirlingtools/stirling-pdf na variante completa (com LibreOffice para conversão de formatos e Tesseract para OCR incluído), expõe-o apenas no loopback do Box e liga-o ao nginx, que o serve no domínio indicado com SSL gratuito.
4. Após iniciar o contentor, o motor verifica adicionalmente se o Stirling-PDF responde via HTTP no seu próprio endpoint de estado, pois o mero status "contentor a funcionar" não garante que o processo interno não tenha entrado numa sequência de reinícios pouco depois.
5. Após a instalação terminar, o Stirling-PDF estará disponível no domínio indicado e pronto a usar, sem necessidade de qualquer conta.

Segurança: por defeito sem login

Stirling-PDF no Saplo arranca sem login, exatamente como a demo oficial do projeto: qualquer pessoa que conheça o endereço pode processar ficheiros. Esta é uma decisão consciente, o mesmo modelo usado para ntfy no Catálogo de aplicações do Saplo. Se precisares de uma instância privada acessível apenas para ti ou para a tua equipa, ativa o login manualmente: nas opções do contentor no Painel, define a variável SECURITY_ENABLELOGIN para true e reinicia a aplicação. No primeiro arranque com o login ativado, o Stirling-PDF cria uma Conta admin/admin que deves imediatamente alterar.

O OCR em polaco requer a instalação de um pacote linguístico adicional

A imagem Stirling-PDF inclui pacotes linguísticos Tesseract para inglês, alemão, francês, português e chinês simplificado, mas SEM polaco. Para o OCR funcionar em polaco, é necessário adicionar o ficheiro pol.traineddata (disponível, por exemplo, no repositório tessdata_fast do projeto Tesseract) e copiá-lo para o volume de dados do contentor via SSH, conforme as instruções automaticamente gravadas no ficheiro STIRLING-PDF-SETUP.txt no Box após a instalação. Sem este passo, o OCR funciona, mas não reconhece corretamente os caracteres diacríticos polacos no texto digitalizado.

Stirling-PDF na Saplo contra ferramentas online

Perguntas frequentes

O Stirling-PDF requer conta ou login? Não por defeito, a instância funciona logo sem login, tal como a demo oficial. Podes ativar o login nas opções do contentor, se precisares de uma instância privada.

O OCR funciona em polaco logo à partida? Não, a imagem inclui apenas inglês, alemão, francês, português e chinês simplificado. O polaco tens de adicionar manualmente, a instrução está disponível no ficheiro STIRLING-PDF-SETUP.txt na Box após a instalação.

O Stirling-PDF precisa de uma base de dados separada? Não, toda a aplicação funciona num único contentor sem base de dados, os documentos não são armazenados permanentemente, apenas processados e enviados de volta.

Os ficheiros ficam no servidor após processamento? Não, o Stirling-PDF não é um armazenamento de ficheiros, o documento entra, é processado e sai, nada fica guardado permanentemente no contentor.

Qual é o limite de tamanho do ficheiro? Por defeito 200 MB por ficheiro, podes aumentar através da variável SYSTEM_MAXFILESIZE nas opções do contentor, se precisares de mais.

Se na tua empresa lidam diariamente com dezenas de ficheiros PDF, juntando orçamentos, a comprimir scans, OCR de faturas, contacta-nos, ajudamos a escolher a Box mais adequada ao teu conjunto de ferramentas.