Base de Conhecimento

Windmill na VPS: automações e scripts da equipe

  • windmill, automação, vps, docker, scripts
  • Usuários acharam útil: 0

Windmill v1.875.0: licença e limites, instalação com Docker Compose, senhas do Postgres, login padrão, domínio com HTTPS, versão fixa, backup e atualização.

Por Redação Eleven Host · @robson.direitodigital · 15 de novembro de 2026 · 9 min de leitura

Arte da Eleven Host: janela de terminal com o título: Windmill na VPS: automações e scripts da equipe

Capa da Redação Eleven Host para o guia do Windmill: Windmill na VPS: automações e scripts da equipe Arte: Eleven Host

Windmill na VPS é uma plataforma para transformar scripts em fluxos, tarefas agendadas e pequenos apps internos, rodando no seu próprio servidor.

Atualizado em 15/11/2026. Se a VPS ainda é novidade, comece por O que é servidor VPS: guia simples para iniciantes. Aqui a ordem dos passos importa: primeiro as senhas, depois a subida dos serviços, o login e só então o domínio com HTTPS.

O que é o Windmill

O repositório oficial descreve o Windmill como uma plataforma centrada em código para fluxos de trabalho, apps e agentes de IA. Na prática, você escreve scripts em linguagens como Python e TypeScript e o Windmill os executa, encadeia, agenda e expõe em telas simples. O projeto se apresenta como alternativa ao n8n, ao Retool e ao Lovable. Essa comparação é do próprio projeto, e não de uma avaliação independente.

Para painéis internos de outro estilo, o artigo Appsmith na VPS: painéis internos da empresa mostra outra opção. A documentação explica que o Postgres guarda o estado inteiro do Windmill e que o restante é sem estado. Por isso, as seções seguintes tratam da senha do banco e da cópia de segurança.

O login padrão da documentação, admin@windmill.dev com a senha changeme, continua ativo até alguém trocá-lo, e quem consegue alcançar a instância entra como superadmin. Troque no primeiro acesso, antes de colocar o servidor sob um domínio público.

Em 15/11/2026, a versão mais nova é a v1.875.0, publicada em 14/11/2026. As versões saem várias vezes por semana, e o repositório segue ativo.

Licença e limites da edição grátis

A licença é mista, e por isso o GitHub a marca como "Other". Segundo o README, o binário compilado sem a opção enterprise é código aberto sob AGPLv3, enquanto os clientes da API e a especificação OpenAPI usam Apache 2.0. Algumas partes Enterprise, como o modo agent e a imagem indexer, exigem uma LICENSE_KEY. Por isso, não é correto chamar o projeto inteiro de código aberto.

O mesmo README diz que usar a Community Edition internamente ou pela API é grátis e dispensa licença comercial, dentro dos limites e cotas definidos no software. Revender ou oferecer o Windmill como serviço gerenciado exige licença comercial.

A página de preços lista os limites do plano grátis: 3 workspaces, no máximo 50 usuários (10 com SSO), 4 grupos, 10 GiB de armazenamento de objetos, 100 e-mails por dia em gatilhos de e-mail e histórico de execuções de até 30 dias. Audit logs, SAML, cofres externos de segredos e autoscaling aparecem como exclusivos do plano Enterprise.

Ficam na loja as opções de servidor virtual da Eleven Host. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS

Antes de começar: Docker e arquivos

A instalação usa o comando docker compose, então o Docker com o Compose precisa estar instalado no servidor antes de tudo; a instalação deles segue a documentação do próprio Docker. Um exemplo de comando para conferir se o Compose está disponível, a ser testado no seu servidor:

docker compose version

A instalação oficial baixa três arquivos para a pasta atual e sobe tudo com o Compose. Um exemplo de comando para criar uma pasta própria antes de baixar, a ser conferido no servidor:

mkdir windmill && cd windmill

Os comandos de download abaixo são os da documentação:

curl https://raw.githubusercontent.com/windmill-labs/windmill/main/docker-compose.yml -o docker-compose.yml

curl https://raw.githubusercontent.com/windmill-labs/windmill/main/Caddyfile -o Caddyfile

curl https://raw.githubusercontent.com/windmill-labs/windmill/main/.env -o .env

Ainda não suba nada: há ajustes a fazer antes do primeiro início.

Se a ideia é publicar apps próprios em containers no mesmo servidor, o artigo Easypanel na VPS: painel para publicar apps com Docker trata de outro uso do Docker.

Trocar as senhas do Postgres antes de subir

O arquivo .env baixado traz a conexão com o banco usando a senha changeme, e o compose usa o postgres:18 como banco incluso. Recomendamos trocar essa senha antes do primeiro início, porque o banco guarda o estado inteiro da plataforma. Essa troca é uma sugestão ainda não testada.

Um exemplo, a conferir no seu servidor: no docker-compose.yml, procure a linha POSTGRES_PASSWORD e troque changeme por uma senha longa. No .env, troque o mesmo trecho dentro da linha DATABASE_URL, que no arquivo original é esta:

DATABASE_URL=postgres://postgres:changeme@db/windmill?sslmode=disable

A senha precisa ser a mesma nos dois arquivos. Uma senha só com letras e números pode evitar problemas com caracteres especiais dentro da URL de conexão.

Portas e tamanho dos workers

O compose publica no servidor a porta 80 e a porta 25, e a linha da 443 vem comentada. A 80 é a entrada do Caddy, o proxy reverso embutido. A 25 é a do SMTP, usada pelos gatilhos de e-mail. Quem não usa gatilho de e-mail pode remover a linha 25:25 do compose, o que pode evitar expor uma porta sem necessidade ou conflitar com outro serviço que já a use. Sugestão sem teste.

O padrão sobe três workers comuns e um worker nativo. A documentação dá como regra prática 1 worker para cada vCPU e entre 1 e 2 GB de memória, e informa que os workers padrão trazem limite de 2048 MB de memória e nenhum limite de processador.

Como o padrão sobe quatro workers, uma ideia para uma VPS pequena é reduzir o valor de replicas do serviço windmill_worker no compose. É uma sugestão também não testada.

Avisos de segurança do próprio compose

Os workers rodam com privileged: true, que segundo a documentação é necessário para isolar os processos dos jobs. O compose também traz a variável REQUIRE_SIGNED_DEBUG_REQUESTS=true, e o comentário avisa para não mudar para false em instalação alcançável pela internet, pois isso expõe um depurador que executa código sem autenticação. Montar /var/run/docker.sock, que vem comentado, dá aos scripts acesso total ao Docker do servidor, e só combina com usuários de total confiança.

Subir e fazer o primeiro login

Com as senhas trocadas e a porta 25 decidida, suba os serviços:

docker compose up -d

A documentação diz para abrir o endereço no navegador, e o compose expõe o Caddy na porta 80. Em uma VPS, o endereço é o IP do servidor, como em http://203.0.113.10 (IP de exemplo, troque pelo seu). Nessa etapa o acesso ainda é por HTTP, sem criptografia, e por isso a troca do login padrão deve acontecer na hora, e a ida para o domínio com HTTPS logo em seguida.

Entre com admin@windmill.dev e a senha changeme e troque esse login logo em seguida, pela interface do Windmill. Se ninguém fizer a troca, o login padrão continua ativo.

Domínio e HTTPS pelo Caddy

O Caddy embutido emite o certificado HTTPS automaticamente. Segundo a documentação, o caminho é trocar o valor :80 da variável BASE_URL pelo seu domínio e descomentar a linha 443:443 das portas no compose. Confira na documentação de instalação do Windmill em qual arquivo essa linha fica antes de editar. O domínio precisa apontar para o IP da VPS antes dessa troca.

A porta 80 deve continuar publicada, pois o Caddy a usa para redirecionar HTTP para HTTPS e em um dos desafios de certificado. A documentação também orienta definir o Base URL nas configurações da instância. Para usar um certificado próprio, o caminho descrito é BASE_URL=":443", com a pasta contendo cert.pem e key.pem montada em /certs.

Depois da edição, aplique a mudança com o mesmo comando de antes e confira no navegador se o domínio abre em HTTPS:

docker compose up -d

Fixar a versão da imagem

O .env usa a imagem ghcr.io/windmill-labs/windmill:main, que acompanha o desenvolvimento mais recente, sem fixar versão. Recomendamos trocar o final :main por uma tag de versão, como 1.875.0, para que cada atualização seja uma decisão sua. Confira no registro de imagens se a tag existe nesse formato antes de usar.

Com a tag fixa, atualizar passa a incluir editar o número da versão no .env antes dos comandos da seção de atualização.

Segurança: o que já foi corrigido e como manter

Em 2026, o projeto publicou cinco avisos de segurança, cada um com versão corrigida, entre eles falhas de gravidade alta. A v1.875.0 está acima das versões corrigidas de todos eles. Isso justifica manter a instalação atualizada.

Como as publicações são frequentes, vale reservar uma rotina para atualizar, com cópia do banco antes.

Backup e atualização

A documentação manda copiar o cluster inteiro do Postgres com pg_dumpall, e não só o banco windmill. O comando oficial gera um arquivo com a data no nome:

(umask 077; docker compose exec -T db pg_dumpall -U postgres > windmill-$(date +%F).sql)

Esse arquivo guarda o hash da senha de cada usuário e o segredo que assina os tokens de sessão. Trate-o como uma senha: permissão restrita e armazenamento fora da VPS.

Faça o backup antes. Recomendamos fazer o backup acima antes de atualizar. A documentação usa dois comandos, nesta ordem. O download pode levar vários minutos, e os containers em execução continuam processando jobs enquanto isso:

docker compose pull

docker compose up -d

Para liberar disco, a documentação cita docker image prune -a, que também apaga imagens de outros projetos no mesmo servidor. Os comandos docker compose down --volumes e docker volume rm -f windmill_db_data aparecem como forma de reiniciar do zero e apagam o banco. Um comentário do compose avisa que dados de Postgres 16 impedem o container postgres:18 de subir, e que a troca de versão do banco exige um pg_dumpall completo.

Endereço de acesso

Uma instância acessada por nome, em vez de só pelo IP, precisa de um domínio apontando para o servidor.

Disponibilidade de nomes se confere direto no campo de registro. Buscar domínio

Perguntas frequentes

O Windmill é gratuito?

A Community Edition é grátis para uso interno da própria empresa, dentro dos limites e cotas do software, como 50 usuários e 3 workspaces. Revender ou oferecer como serviço exige licença comercial.

Todo o Windmill é código aberto?

Não. O binário sem a opção enterprise é código aberto sob AGPLv3, mas há partes Enterprise que exigem uma chave de licença.

Preciso trocar o login padrão?

Sim. A documentação avisa que o login admin@windmill.dev com a senha changeme continua ativo se ninguém o trocar, e quem alcança a instância entra como superadmin.

Como faço a cópia de segurança?

Com pg_dumpall do cluster inteiro, e não só do banco windmill. O arquivo gerado guarda hashes de senha e deve ser tratado como senha.

Como atualizo o Windmill?

Com docker compose pull e depois docker compose up -d, de preferência depois de uma cópia do banco. Em 15/11/2026, a versão mais nova é a v1.875.0.

Esta resposta lhe foi útil?

Artigos Relacionados