Base de Conhecimento

Stirling-PDF na VPS: ferramentas de PDF no seu servidor

  • stirling-pdf, ferramentas de pdf, docker, vps, lgpd
  • Usuários acharam útil: 0

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

Arte da Eleven Host: janela de terminal com o título: Stirling-PDF na VPS: ferramentas de PDF no seu servidor

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, como 3.3.0): com login e configurações de admin, e com LibreOffice, Tesseract e OCRmyPDF, entre outros. Memória sugerida: 4 GB.
  • latest-fat (ou 3.3.0-fat): tudo isso, mais um motor de IA embutido, desligado até ser ativado. Sugestão: 6 GB.
  • latest-ultra-lite (ou 3.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 para SECURITY_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.

Esta resposta lhe foi útil?

Artigos Relacionados