Stirling-PDF na VPS: ferramentas de PDF no seu servidor
Stirling-PDF 3.3.0: licença open-core, edição grátis até 5 usuários, alertas de segurança, instalação com Docker Compose, Nginx, HTTPS, backup e atualização.
Por Redação Eleven Host · @robson.direitodigital · 13 de novembro de 2026 · 10 min de leitura

Capa da Redação Eleven Host para o guia: Stirling-PDF na VPS: ferramentas de PDF no seu servidor Arte: Eleven Host
Stirling-PDF na VPS é uma forma de ter ferramentas de PDF, como juntar, dividir, converter e OCR, num servidor seu, com API. Veja a licença, a versão, a instalação com Docker, o HTTPS, o backup e a atualização.
Atualizado em 13/11/2026. Os blocos de comandos e de configuração abaixo são exemplos: confira cada um no seu servidor antes de usar.
O que é o Stirling-PDF
O Stirling-PDF é uma plataforma de edição de PDF de código aberto, que roda no desktop, no navegador ou no seu próprio servidor, com API privada, para que os documentos não precisem ir a serviços de fora. São mais de 50 ferramentas: editar, juntar, dividir, assinar, tarjar trechos, converter, aplicar OCR e comprimir.
Há também automação sem código e uma API REST para quase todas as ferramentas. O guia completo de servidor VPS explica o que é uma VPS, para quem ainda não tem uma.
O Stirling-PDF é open-core: o núcleo é MIT, e algumas partes têm licença própria. A edição grátis vai até 5 usuários. Na data de hoje, a versão estável é a 3.3.0, de 05/11/2026, e recomendamos usá-la ou uma mais nova, com a tag fixada no compose.
Licença e planos
O repositório se descreve como open-core. O arquivo de licença aplica a MIT ao conteúdo fora de certas pastas, como app/proprietary/ e engine/, que têm licença própria. Por isso a licença MIT não cobre o repositório inteiro.
- Free, o padrão de quem hospeda: todas as ferramentas de PDF, API REST, SSO com OAuth2/OIDC, assinatura com certificado do servidor e limite de 5 usuários.
- Team: o que há no Free, mais banco externo, cluster e armazenamento em S3.
- Enterprise: o que há no Team, mais SSO com SAML2, log de auditoria e ativação offline, vendido pela equipe do projeto.
Os planos pagos têm preços definidos pelo fabricante. A automação e as ferramentas de IA consomem uma cota mensal de processamento, exceto no Enterprise.
Versão e alertas de segurança
O projeto está ativo: quatro versões saíram entre 15/10 e 05/11/2026. A 3.3.0 traz melhorias de segurança e estabilidade, com recomendação de atualizar, e remove a API antiga de edição de texto do backend.
Em 2026 houve vários alertas de segurança. Em outubro saiu um alerta crítico (GHSA-mrr8-934j-4g8m), de execução remota de código. Ele exigia um administrador autenticado, e a prova de conceito usava as credenciais padrão do admin. As versões até a 2.11.0 eram afetadas, e a correção veio na 2.13.2.
Por isso o exemplo abaixo fixa a tag 3.3.0, em vez de latest, como a documentação orienta, para que as atualizações aconteçam quando você escolher.
Variantes da imagem e memória
A documentação oferece três variantes da imagem e sugere uma memória para cada uma:
latest(ou a versão fixa, como3.3.0): com login e configurações de admin, e com LibreOffice, Tesseract e OCRmyPDF, entre outros. Memória sugerida: 4 GB.latest-fat(ou3.3.0-fat): tudo isso, mais um motor de IA embutido, desligado até ser ativado. Sugestão: 6 GB.latest-ultra-lite(ou3.3.0-ultra-lite): sem login, só com ferramentas básicas de PDF, sem OCR, Office, HTML nem ebook. Sugestão: 2 GB. Sem login, recomendamos não expô-la à internet; o mesmo vale paraSECURITY_ENABLELOGIN=false.
Para produção, a documentação fala em pelo menos 4 GB. O exemplo define um limite de memória no contêiner, e a imagem calcula o heap do Java a partir dele.
A documentação sugere 4 GB de memória para a imagem principal; na loja, confira o que cada plano inclui. Ver as VPS
Antes de começar: subdomínio e Docker
Primeiro, um subdomínio, como pdf.exemplo.com.br, apontando para o IP da VPS antes do certificado. Para domínios registrados conosco, há DNS gerenciado grátis na rede da Cloudflare, com painel na área do cliente.
Segundo, o Docker. Antes de instalar, configure o repositório apt oficial, seguindo a documentação do Docker para o Ubuntu. Depois, a instalação e o teste da documentação:
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo docker run hello-world
Pastas, compose e primeiro início
O contêiner roda com UID e GID 1000. Se as pastas do host pertencerem a outro usuário, o Stirling-PDF não consegue gravar, e a saída é definir PUID e PGID. Um exemplo de comandos para criar as pastas e ver os números do seu usuário:
mkdir -p ~/stirling-pdf/stirling-data/configs ~/stirling-pdf/stirling-data/storage ~/stirling-pdf/stirling-data/customFiles
cd ~/stirling-pdf
id -u
id -g
Se os números não forem 1000, acrescente PUID e PGID em environment. Segue um exemplo de docker-compose.yml para a pasta ~/stirling-pdf, montado a partir da estrutura da documentação, que traz também as pastas logs, pipeline e tessdata: copie o bloco completo do site se precisar delas e confira o exemplo no seu servidor.
Três pontos no exemplo. A tag está fixa em 3.3.0. A porta é publicada como 127.0.0.1:8080:8080: o Docker, ao publicar uma porta sem endereço, a abre em todas as interfaces e passa por cima das regras do firewall, como o ufw, e por isso a 8080 ficaria exposta em HTTP, por fora do Nginx. E as variáveis SECURITY_INITIALLOGIN_USERNAME e SECURITY_INITIALLOGIN_PASSWORD criam o primeiro admin antes do primeiro início; a documentação diz que as duas são ignoradas depois que o banco já tem usuários.
Crie o arquivo com nano docker-compose.yml, dentro de ~/stirling-pdf, e cole este conteúdo:
services:
stirling-pdf:
image: docker.stirlingpdf.com/stirlingtools/stirling-pdf:3.3.0
container_name: stirling-pdf
ports:
- "127.0.0.1:8080:8080"
environment:
SECURITY_INITIALLOGIN_USERNAME: ana
SECURITY_INITIALLOGIN_PASSWORD: TROQUE_ESTA_SENHA
volumes:
- ./stirling-data/configs:/configs
- ./stirling-data/storage:/storage
- ./stirling-data/customFiles:/customFiles
mem_limit: 4g
restart: unless-stopped
Se docker.stirlingpdf.com não responder, a documentação indica o Docker Hub (stirlingtools/stirling-pdf). Depois de trocar a senha de exemplo, suba o serviço e confira o registro:
sudo docker compose up -d
sudo docker compose ps
sudo docker logs stirling-pdf
Senha padrão
Sem as variáveis de admin inicial, o servidor cria o usuário admin com a senha stirling, e o primeiro login exige uma senha nova, de no mínimo 8 caracteres. Até alguém entrar, a tela fica aberta na internet, e a prova de conceito do alerta crítico de outubro usava credenciais padrão. Por isso o exemplo define o admin antes do primeiro início.
Nginx com HTTPS
Com a porta presa ao 127.0.0.1, o acesso de fora passa pelo Nginx. O exemplo abaixo adapta o bloco da documentação, começando só pela porta 80, para o Certbot cuidar do certificado em seguida. As linhas do proxy são as da documentação: client_max_body_size 2000M, porque o Nginx aceita só 1 MB por padrão e o limite de upload do aplicativo é de 2000 MB; proxy_buffering off; e timeouts de 1800 segundos, para tarefas longas.
sudo apt install nginx
sudo nano /etc/nginx/sites-available/pdf.exemplo.com.br
server {
listen 80;
server_name pdf.exemplo.com.br;
client_max_body_size 2000M;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-Host $host;
proxy_set_header X-Forwarded-Port $server_port;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_buffering off;
proxy_read_timeout 1800s;
proxy_send_timeout 1800s;
}
}
Depois, um exemplo de comandos para ativar o bloco, testar a sintaxe, recarregar o Nginx e pedir o certificado. O Certbot precisa estar instalado antes, e o passo a passo está no artigo Certbot na VPS: SSL grátis do Let's Encrypt no Nginx.
sudo ln -s /etc/nginx/sites-available/pdf.exemplo.com.br /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
sudo certbot --nginx -d pdf.exemplo.com.br
Primeiro login
Abra https://pdf.exemplo.com.br no navegador e entre com o admin definido no compose. Se você não definiu um, entre com admin e stirling e troque a senha no mesmo instante. Depois de 5 tentativas erradas, o login fica bloqueado por 120 minutos, segundo a documentação.
Telemetria
Quando system.enableAnalytics não está definido, o primeiro admin vê uma pergunta sobre ajudar a melhorar o Stirling-PDF, e nada é enviado até alguém responder. Se a resposta for sim, o servidor manda ao PostHog, na União Europeia, dados como versão, sistema, número de usuários e contagem de operações, e a documentação afirma que o conteúdo dos documentos não é enviado.
Para desligar tudo e esconder o aviso, defina a variável abaixo em environment e suba de novo o serviço:
SYSTEM_ENABLEANALYTICS: "false"
Arquivos que ficam no servidor
O armazenamento de arquivos vem ligado: quem está logado guarda documentos em My Files, na pasta /storage, e os compartilha com outros usuários, e eles ficam até alguém apagar. Os exemplos da documentação trazem cota -1, que significa sem limite, e por isso o disco pode encher. Um exemplo de comando mostra o uso, e o artigo Quanto de disco precisa uma VPS: como calcular ajuda a fazer a conta:
df -h
du -sh ~/stirling-pdf/stirling-data/storage
Uma limpeza diária remove links de compartilhamento vencidos e arquivos órfãos. Para arquivos processados sem salvar em My Files, quem lida com documentos delicados deve conferir no próprio servidor o que fica nos temporários.
Backup e atualização
A documentação manda copiar a pasta configs/ inteira, que guarda as configurações, as chaves geradas e o banco embutido, e a pasta storage/, que guarda os arquivos salvos no servidor. Um exemplo de cópia, feita dentro de ~/stirling-pdf e com o serviço parado por cautela, já que o banco está em configs:
sudo docker compose stop
sudo tar czf stirling-backup.tar.gz stirling-data/configs stirling-data/storage
sudo docker compose start
Recomendamos levar a cópia para fora da VPS: o artigo Backup da VPS: como fazer cópia automática mostra como automatizar isso.
Para atualizar, faça o backup, troque a tag no compose, por exemplo de 3.3.0 para a versão seguinte, depois de ler as notas dela, e rode os dois comandos abaixo. Como a tag é fixa, o pull sozinho não muda nada: a versão só avança quando você edita a tag. Anote a tag antiga, para poder voltar.
sudo docker compose pull
sudo docker compose up -d
Documentos com dados pessoais e LGPD
Contratos, laudos e documentos de identificação podem ir para uma ferramenta de PDF e trazer dados pessoais. A LGPD trata esse tipo de informação, e hospedar o próprio servidor não resolve sozinho as obrigações da lei. Recomendamos limitar quem tem conta, manter o HTTPS e as atualizações em dia e tratar o assunto com o jurídico da empresa.
O endereço do servidor de PDF
O subdomínio usado nos exemplos, pdf.exemplo.com.br, parte de um domínio registrado.
O domínio principal do subdomínio pode ser registrado na Eleven Host, que tem centenas de extensões. Buscar domínio
Perguntas frequentes
O Stirling-PDF é gratuito?
A edição grátis para hospedar por conta própria inclui todas as ferramentas de PDF e a API REST, com limite de 5 usuários. O projeto é open-core, com núcleo MIT e partes sob licença própria, e os planos Team e Enterprise são pagos, com preços definidos pelo fabricante.
Qual versão usar na data de hoje?
A 3.3.0, de 05/11/2026, ou uma mais nova. Houve alertas de segurança em 2026, entre eles um crítico em outubro, e recomendamos fixar a tag no compose.
Posso usar a variante ultra-lite exposta na internet?
Recomendamos não. Ela não tem login, e quem alcançasse o endereço poderia usar as ferramentas.