Penpot na VPS: design colaborativo no seu servidor
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

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 oPENPOT_HTTP_SERVER_MAX_BODY_SIZEdo compose, cerca de 350 MiB;- locations de websocket para
/ws/notificationse/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.