Base de Conhecimento

Penpot na VPS: design colaborativo no seu servidor

  • penpot, design, docker, vps, lgpd
  • Usuários acharam útil: 0

Penpot 2.19.1: licença MPL-2.0, disco recomendado, instalação com Docker Compose, HTTPS com proxy, e-mail, correções de segurança, 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: Penpot na VPS: design colaborativo no seu servidor

Capa da Redação Eleven Host para o guia: Penpot na VPS: design colaborativo no seu servidor Arte: Eleven Host

Penpot na VPS é a plataforma de design e protótipo de código aberto rodando no seu próprio servidor, com colaboração em tempo real: instalação com Docker Compose, HTTPS, e-mail, backup e atualização.

Atualizado em 13/11/2026. Na data de hoje, a versão estável mais nova é a 2.19.1, publicada em 11/11/2026. Os blocos de exemplo não foram executados: confira cada um no seu servidor.

O que é o Penpot e qual é a licença

O Penpot é uma plataforma de design e protótipo para equipes de produto, com colaboração em tempo real e instalação no servidor da própria equipe. Há design tokens, componentes e variantes, layouts com CSS Grid e Flex e o modo Inspect, que gera código SVG, CSS e HTML.

O Penpot é código aberto sob a licença MPL-2.0. Na data de hoje, a versão estável é a 2.19.1, e o compose oficial vem com a série 2.18 por padrão, então a versão precisa ser definida na instalação.

Há uma parte paga: o Penpot Enterprise, plano para organizações com governança, segurança, administração e login único (SSO), na nuvem ou no seu servidor. Há também a versão hospedada pela empresa, e os preços são do fabricante.

Para quem serve

São exemplos de uso, sem promessa de resultado: uma equipe de produto que quer desenhar telas e protótipos em conjunto, ou uma empresa que prefere guardar os arquivos de design num servidor sob o seu controle. O guia completo de servidor VPS explica o básico para quem ainda não usa um servidor.

Versão e segurança: use a 2.19.1 ou mais nova

Em 05/11/2026 e em 11/11/2026, o projeto publicou avisos de segurança. Entre eles, uma leitura arbitrária de arquivo pelos endpoints de miniatura, que pode expor a chave secreta e as credenciais do banco, corrigida na 2.18.6, e um sanitizador de SVG incompleto, corrigido na 2.19.1. Por isso recomendamos instalar a 2.19.1 ou uma versão mais nova.

A documentação diz que o compose usa a imagem mais recente por padrão. O arquivo atual, porém, fixa a tag 2.18, que aponta para a série 2.18.x. Quem só baixa o arquivo e sobe os contêineres fica fora das correções de 11/11, e a saída é definir a variável PENPOT_VERSION, mais abaixo.

Espaço em disco

A documentação do Penpot descreve 4 CPUs e 16 GB de memória como suficientes para milhares de usuários. Para o disco, o ponto de partida é um banco de 50 GB a 100 GB, com crescimento elástico, para até 10 editores. Acima de 10 editores, a conta soma cerca de 5 GB por editor, e o uso deve ser monitorado todo mês.

Para fazer a conta do seu caso, veja o artigo Quanto de disco precisa uma VPS: como calcular.

Servidores virtuais ficam à venda no catálogo; confira na loja o que cada plano inclui. Ver as VPS

Instalar o Docker

O método principal de instalação é o Docker Compose. Primeiro adicione o repositório oficial do Docker, seguindo a página docs.docker.com/engine/install/ubuntu, que cobre o Ubuntu 22.04 LTS, 24.04 LTS, 26.04 LTS e 26.10, de 64 bits. Depois instale os pacotes, que já incluem o Compose, e rode o teste:

sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

sudo docker run hello-world

Os comandos docker seguintes aparecem sem sudo: se o seu usuário não estiver no grupo docker, use sudo neles.

Os comandos docker das próximas seções aparecem sem sudo. Se o seu usuário não estiver no grupo docker, use sudo antes de cada um.

Baixar o compose oficial

Crie uma pasta para a instalação e baixe o arquivo do compose, que é o mesmo da documentação oficial:

mkdir penpot

cd penpot

wget https://raw.githubusercontent.com/penpot/penpot/main/docker/images/docker-compose.yaml

O compose padrão é de laboratório

Ele traz uma chave secreta insegura, a senha penpot no banco, o cadastro público aberto e duas flags que o próprio arquivo manda remover antes de expor o Penpot à internet. Nada sobe ainda: primeiro vêm as edições abaixo.

Editar antes do primeiro início

Primeiro, fixe a versão. Crie um .env na mesma pasta do compose, com a linha abaixo, que é um exemplo:

PENPOT_VERSION=2.19.1

Segundo, a chave secreta. O PENPOT_SECRET_KEY vem como change-this-insecure-key. Ela é a chave mestra de onde saem as chaves de sessão e de convite, e trocá-la depois invalida as sessões e os convites existentes. A documentação sugere gerar o valor assim, e você cola o resultado no arquivo:

python3 -c "import secrets; print(secrets.token_urlsafe(64))"

Terceiro, a senha do banco. Ela aparece em PENPOT_DATABASE_PASSWORD e em POSTGRES_PASSWORD, ambas com o valor penpot. Troque as duas pela mesma senha forte, antes do primeiro início, porque o banco nasce com a senha que estiver no arquivo nesse momento.

Quarto, o endereço. O PENPOT_PUBLIC_URI vem como http://localhost:9001. Troque pelo endereço https real, como https://design.exemplo.com, nos serviços de backend, frontend e exporter. O DNS desse endereço já deve apontar para o IP da VPS. A Eleven Host oferece DNS gerenciado grátis na rede da Cloudflare para domínios registrados conosco, com painel na área do cliente.

Quinto, as portas. O compose publica a 9001, do Penpot, e a 8025, do mailpit, que é a caixa de e-mail de teste, em todas as interfaces. O Docker passa por cima das regras do ufw, então um ufw ligado não protege essas portas. Como o proxy ficará na mesma VPS, troque as linhas por estas, que são um exemplo:

"127.0.0.1:9001:8080"

"127.0.0.1:8025:8025"

A primeira substitui "9001:8080" no frontend e a segunda substitui "8025:8025" no mailpit.

Subir e criar o primeiro usuário

Com tudo editado, suba os contêineres e confira os nomes:

docker compose -p penpot -f docker-compose.yaml up -d

docker ps

O compose padrão deixa o cadastro público aberto e sem confirmação de e-mail. Por isso o primeiro usuário vai pela linha de comando, dentro do contêiner do backend. O comando é manage.py, e o nome do contêiner depende do -p penpot: confira na saída do docker ps, porque pode ser penpot-penpot-backend-1 ou penpot_penpot-backend-1. Um exemplo de comando:

docker exec -ti penpot-penpot-backend-1 python3 manage.py create-profile

O comando aceita --skip-tutorial --skip-walkthrough, e o perfil criado assim fica com o e-mail não verificado. Agora feche o cadastro público: acrescente disable-registration à linha PENPOT_FLAGS e recrie os contêineres com o mesmo up -d. Os convites continuam criando contas, desde que o login por senha esteja ligado.

HTTPS com proxy Nginx e Certbot

A documentação recomenda fortemente o HTTPS. Sem HTTPS, fora do localhost, o login só segura a sessão com a flag disable-secure-session-cookies, e a área de transferência não funciona.

Instale o Nginx e emita o certificado com o artigo Certbot na VPS: SSL grátis do Let's Encrypt no Nginx. Para o bloco do Nginx, copie o exemplo da seção Configure the proxy and HTTPS da página help.penpot.app/technical-guide/getting-started/docker, em vez de montar de memória. A documentação descreve estes pontos, que valem conferir no que você copiar:

  • a porta 80 redireciona para a 443;
  • client_max_body_size 367001600;, valor que deve casar com o PENPOT_HTTP_SERVER_MAX_BODY_SIZE do compose, cerca de 350 MiB;
  • locations de websocket para /ws/notifications e /mcp/ws, com os cabeçalhos Upgrade e Connection;
  • a location principal repassando para http://localhost:9001/, com X-Real-IP, X-Forwarded-For e X-Forwarded-Proto.

Se o bloco copiado apontar para arquivos de certificado que ainda não existem, emita o certificado antes de recarregar o Nginx.

Tirar a flag do cookie seguro

Com o endereço https abrindo e o login funcionando, edite a linha PENPOT_FLAGS e remova disable-secure-session-cookies, mantendo as demais, inclusive disable-registration. A flag disable-email-verification fica por enquanto, com o cadastro público já fechado, e só sai depois de configurar o SMTP real, na próxima seção. Se a flag enable-smtp já estiver na linha, deixe-a. Depois recrie os contêineres:

docker compose -p penpot -f docker-compose.yaml up -d

E-mail de verdade no lugar do mailpit

O mailpit é um SMTP temporário de teste, e as mensagens ficam só na memória. Antes de ligar a verificação de e-mail, aponte o Penpot para um SMTP real. As variáveis são PENPOT_SMTP_HOST, PENPOT_SMTP_PORT (por exemplo 587), PENPOT_SMTP_USERNAME, PENPOT_SMTP_PASSWORD, PENPOT_SMTP_TLS (por exemplo true) e PENPOT_SMTP_DEFAULT_FROM. Os padrões do compose apontam para o penpot-mailpit, na porta 1025. Depois de trocar os valores, remova disable-email-verification da linha PENPOT_FLAGS e rode o up -d de novo. Em seguida, confira se o login do primeiro usuário continua funcionando.

Backup e atualização

Os dados ficam em dois volumes do Docker: penpot_postgres_v15, com o banco, e penpot_assets, com os arquivos enviados. Confira os nomes exatos no seu servidor com docker volume ls. A documentação manda não copiar a pasta do volume direto, e sim usar o procedimento de backup de volume do Docker, com um contêiner temporário que gera um arquivo.

Recomendamos parar os contêineres, copiar os dois volumes pelo procedimento do Docker e guardar a cópia fora da VPS, no mesmo cuidado do artigo Backup da VPS: como fazer cópia automática. Guarde também o compose editado, que tem a chave secreta e a senha do banco, e o .env. Para parar e subir de novo, os comandos são:

docker compose -p penpot -f docker-compose.yaml down

docker compose -p penpot -f docker-compose.yaml up -d

Para atualizar, com a cópia pronta, troque o PENPOT_VERSION no .env, rode o pull e depois o up -d para recriar os contêineres. A documentação pede passos pequenos, sem pular versões distantes.

docker compose -p penpot -f docker-compose.yaml pull

docker compose -p penpot -f docker-compose.yaml up -d

Telemetria e dados da equipe

Um Penpot da equipe guarda nomes e e-mails de pessoas, além de comentários com o nome de quem os escreveu. A LGPD, a lei brasileira de proteção de dados, trata esse tipo de informação, e um software não garante conformidade sozinho. Recomendamos limitar quem tem conta, manter o HTTPS ligado, guardar a cópia fora do servidor e tratar o assunto com o jurídico da empresa.

O compose traz PENPOT_TELEMETRY_ENABLED com o valor true: a telemetria vem ligada.

Endereço da equipe

O endereço da equipe é o que as pessoas digitam no navegador para abrir o Penpot.

Quem monta um endereço como design.exemplo.com precisa de um domínio registrado, e há centenas de extensões na busca da Eleven Host. Buscar domínio

Perguntas frequentes

O Penpot é gratuito?

O código é aberto, sob a licença MPL-2.0, e dá para instalar no seu servidor. O plano Enterprise, com governança, segurança, administração e login único, é pago, e os preços são do fabricante.

Qual é a versão estável na data de hoje?

A 2.19.1, publicada em 11/11/2026. O compose oficial vem com a série 2.18 por padrão, então defina a versão no .env.

Posso usar o Penpot só em HTTP?

Fora do localhost, o login exige a flag disable-secure-session-cookies, que não é recomendada em produção, e a área de transferência não funciona. O caminho indicado pela documentação é o HTTPS.

Esta resposta lhe foi útil?

Artigos Relacionados