Base de Conhecimento

DocuSeal na VPS: assinatura de documentos no seu servidor

  • docuseal, assinatura eletrônica, docker, vps, lgpd
  • Usuários acharam útil: 0

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

Arte da Eleven Host: janela de terminal com o título: DocuSeal na VPS: assinatura de documentos no seu servidor

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.

Esta resposta lhe foi útil?

Artigos Relacionados