DocuSeal na VPS: assinatura de documentos no seu servidor
DocuSeal 3.3.6: licença AGPLv3 com atribuição obrigatória, recursos do Pro, requisitos oficiais, instalação com Docker Compose e Caddy, SMTP, atualização e backup.
Por Redação Eleven Host · @robson.direitodigital · 12 de novembro de 2026 · 9 min de leitura

Capa da Redação Eleven Host para o guia: DocuSeal na VPS: assinatura de documentos no seu servidor Arte: Eleven Host
DocuSeal na VPS é a forma de colocar a assinatura eletrônica de documentos no seu próprio servidor, com o DocuSeal, uma plataforma de código aberto. Veja a licença, o que fica só no plano Pro, os requisitos e a instalação com Docker Compose.
Atualizado em 12/11/2026. Na data de hoje, a versão estável mais nova é a 3.3.6, publicada em 09/11/2026. Os blocos marcados como exemplo são sugestões, não a configuração oficial do projeto: confira cada um no seu servidor antes de usar.
O que é o DocuSeal e qual é a licença
O DocuSeal, mantido pela DocuSeal LLC, serve para criar modelos de documento, marcar os campos a preencher e colher as assinaturas. O construtor de campos em PDF é visual. Um documento pode ter vários signatários, e cada um recebe a sua cópia assinada. Há ainda API, webhooks e envio de e-mails por SMTP.
A licença é a AGPLv3 com um termo adicional (Seção 7(b)): a interface deve manter a atribuição original do DocuSeal. Na versão aberta, essa atribuição deve permanecer na interface.
A versão aberta mantém a atribuição do DocuSeal na interface. Marca própria (white-label), SSO, papéis de usuário e outros recursos ficam no Pro, que é uma imagem privada paga.
O Pro autohospedado é uma imagem Docker separada e privada, ativada por uma chave de licença comprada no console do DocuSeal. Pelo README, entram no Pro o logo da empresa, os papéis de usuário, os lembretes automáticos, o convite por SMS, os campos condicionais e fórmulas, o envio em massa por planilha e o SSO/SAML.
Para quem serve
São exemplos de uso, sem promessa de resultado: um escritório que envia contratos de serviço para assinar, ou uma empresa que colhe termos e autorizações de clientes e quer guardar os arquivos no próprio servidor. Para entender o que é uma VPS, o guia completo de servidor VPS explica o básico.
Validade jurídica: o que a lei brasileira diz
A Lei 14.063/2020 classifica as assinaturas eletrônicas em simples, avançada e qualificada. A validade de um documento depende do tipo de assinatura e do caso concreto, e por isso vale procurar um advogado antes de usar o sistema em contratos importantes.
Por padrão, a instalação própria gera o seu certificado de assinatura. Ele não é um certificado da ICP-Brasil. A documentação do DocuSeal descreve o envio de um certificado próprio, nos formatos .p12, .pfx e .der, em Settings, E-Signature.
Requisitos oficiais
A página de requisitos do DocuSeal traz valores aproximados, calculados para guardar 10.000 documentos assinados. A CPU e a memória dependem do tamanho médio de cada documento:
- 500 KB: 1 vCPU e 1 GB de RAM;
- 5 MB: 1 vCPU e 2 GB de RAM;
- 100 MB: 2 vCPU e 4 GB de RAM.
O disco depende também de como o modelo é usado. Para 10.000 documentos de 500 KB, a página indica 12 GB quando o modelo é de uso único com um signatário, e 25 GB com vários signatários. Para documentos de 5 MB, são 125 GB e 225 GB. Para documentos de 100 MB, são 2.250 GB e 4.500 GB. Modelos reutilizados pedem menos. Arquivos grandes ou muitos acessos simultâneos pedem mais memória, e SSD ajuda com arquivos grandes.
Sobre o banco de dados, o PostgreSQL é o principal e o recomendado. SQLite e MySQL têm compatibilidade parcial. Abaixo de 1.000 documentos por ano, a página diz que qualquer um serve. Para uso por API ou embutido em produção, com 1.000 ou mais documentos por ano, a página indica o PostgreSQL. Dúvidas sobre a VPS da Eleven Host vão para o atendimento em português do Brasil, pela área do cliente e por tickets.
VPS da Eleven Host: seis planos listados na loja. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS
Instalação com Docker Compose, na ordem
O caminho oficial usa o docker-compose.yml do repositório, que já inclui o Caddy, para o HTTPS automático, e o PostgreSQL. A ordem importa, porque o Caddy emite o certificado sozinho e, para isso, o DNS do domínio precisa já apontar para o servidor.
Primeiro, o Docker com o Compose precisa estar instalado no servidor, seguindo a documentação do próprio Docker para o seu sistema. Segundo, o domínio precisa apontar para o IP da VPS antes do primeiro início. O README pede exatamente isso: o DNS deve apontar para o servidor para o Caddy emitir o certificado. Se ainda não há domínio, o guia completo de registro de domínio explica como funciona. Para domínios registrados conosco, o DNS gerenciado grátis na rede da Cloudflare fica no painel da área do cliente.
Terceiro, crie uma pasta e baixe nela o docker-compose.yml do repositório docusealco/docuseal, no GitHub. Antes de subir, ajuste dois pontos do arquivo oficial. O primeiro é a senha: o exemplo usa postgres:postgres, em duas linhas, DATABASE_URL e POSTGRES_PASSWORD. Recomendamos trocar nas duas, pela mesma senha forte, antes do primeiro início. Se o banco já tiver iniciado alguma vez, a pasta ./pg_data pode manter a senha antiga, e mudar só o arquivo não basta: nesse caso, confira na documentação do PostgreSQL como trocar a senha dentro do banco. Um exemplo, com senha fictícia:
- DATABASE_URL=postgresql://postgres:troque-esta-senha@postgres:5432/docuseal
POSTGRES_PASSWORD: troque-esta-senha
O segundo ponto é a porta 3000. O arquivo oficial publica a 3000 do serviço app além da 80 e da 443 do Caddy, e com isso o sistema fica acessível sem HTTPS por essa porta. Como o Caddy fala com o aplicativo pela rede interna do Compose, recomendamos apagar as duas linhas ports: e - 3000:3000 do serviço app, ou trocar por 127.0.0.1:3000:3000.
O arquivo oficial usa a tag latest para o DocuSeal e para o Caddy. Recomendamos fixar a versão do DocuSeal, por exemplo docuseal/docuseal:3.3.6, para que uma atualização aconteça quando você decidir. O README usa sudo HOST=your-domain-name.com docker compose up. O exemplo abaixo usa -d, com domínio fictício:
sudo HOST=docuseal.exemplo.com docker compose up -d
O arquivo usa a variável HOST, e por isso os exemplos seguintes também a trazem, por precaução; confira no seu servidor se ela é necessária neles. O compose grava os dados em três pastas ao lado do arquivo: ./docuseal para os arquivos, ./pg_data para o banco e ./caddy para os certificados.
Para o primeiro acesso, abra o domínio no navegador. Siga o que a tela indicar. Ao criar ou definir qualquer senha de acesso, use uma senha forte e exclusiva.
Alternativa simples: um contêiner só
O README traz também um comando de um contêiner só: docker run --name docuseal -p 3000:3000 -v.:/data docuseal/docuseal. O trecho -v.:/data, sem espaço, monta a pasta atual em /data. Esse caminho usa o banco SQLite por padrão e não traz HTTPS: o acesso fica na porta 3000.
E-mail e configurações do aplicativo
O DocuSeal envia os e-mails de assinatura por SMTP. A configuração pode ser feita pela tela de configurações ou pelas variáveis SMTP_ADDRESS, SMTP_PORT, SMTP_USERNAME, SMTP_PASSWORD e SMTP_FROM, entre outras. O STARTTLS e a verificação do certificado vêm ligados por padrão, e recomendamos deixar assim. Um exemplo de bloco para o serviço app, com valores fictícios, em environment:
- SMTP_ADDRESS=smtp.exemplo.com
- SMTP_PORT=587
- SMTP_USERNAME=usuario@exemplo.com
- SMTP_PASSWORD=troque-esta-senha
- SMTP_FROM=assinatura@exemplo.com
As demais variáveis são opcionais. A SECRET_KEY_BASE pode ser gerada com openssl rand -hex 64. A sessão de login dura 730 dias por padrão, valor da variável SESSION_REMEMBER_DAYS, e recomendamos reduzir se o sistema for usado em computadores compartilhados.
Atualização
O DocuSeal publicou uma versão estável por semana entre 05/10/2026 (3.3.1) e 09/11/2026 (3.3.6). Duas notas merecem atenção: a 3.3.4 trouxe uma migração demorada do banco, e na 3.3.6 os links de download anteriores a fevereiro de 2024 passam a dar erro 404.
A página oficial de atualização usa, no Compose, docker-compose up --force-recreate. Com uma tag fixa, um caminho possível é mudar a tag no arquivo e rodar os comandos abaixo, depois de uma cópia de segurança. Um exemplo, a conferir no seu servidor:
sudo HOST=docuseal.exemplo.com docker compose pull
sudo HOST=docuseal.exemplo.com docker compose up -d
Backup
Não há um guia oficial de backup do DocuSeal; o que segue é uma sugestão a conferir no seu servidor. Com o compose oficial, vale guardar as pastas ./docuseal e ./pg_data, o docker-compose.yml e as variáveis usadas. Se os anexos estiverem em S3, GCS ou Azure, eles ficam no bucket. Um exemplo, a conferir no seu servidor: um dump do PostgreSQL e uma cópia da pasta dos arquivos.
sudo HOST=docuseal.exemplo.com docker compose exec -T postgres pg_dump -U postgres docuseal > docuseal.sql
sudo tar czf docuseal-arquivos.tar.gz docuseal docker-compose.yml
Cópia que fica só no mesmo servidor some junto com ele. O artigo Backup da VPS: como fazer cópia automática trata de cópia automática da VPS.
Dados dos signatários e LGPD
Um sistema de assinatura guarda nomes, e-mails e os próprios documentos assinados, e a LGPD, a lei brasileira de proteção de dados, trata esse tipo de informação. Um software não garante conformidade sozinho. Recomendamos limitar quem acessa o sistema, manter o HTTPS, guardar a cópia de segurança fora do servidor e tratar o assunto com quem cuida do jurídico do negócio.
O endereço do sistema
O domínio usado em HOST precisa existir antes da instalação.
Nomes e extensões à escolha: a Eleven Host registra domínios com centenas de extensões. Buscar domínio
Perguntas frequentes
O DocuSeal é gratuito?
A versão aberta pode ser instalada sem pagar licença, mas white-label, SSO, papéis de usuário, lembretes e envio em massa ficam no Pro, que é pago. Os preços são do DocuSeal.
A assinatura tem validade jurídica no Brasil?
A Lei 14.063/2020 classifica as assinaturas eletrônicas em simples, avançada e qualificada, e a validade depende do tipo de assinatura e do caso. Procure um advogado. O certificado padrão da instalação não é da ICP-Brasil.
Posso tirar a marca do DocuSeal da interface?
Na versão aberta, não: a licença exige manter a atribuição original. A marca própria é um recurso do Pro.
Qual banco de dados usar?
O PostgreSQL é o recomendado pela documentação, e é o que o compose oficial traz. SQLite e MySQL têm compatibilidade parcial.
Preciso de um domínio?
Para o HTTPS automático do compose oficial, sim, com o DNS já apontado.