Dokploy na VPS: publique apps no seu servidor
Dokploy 0.31.1: licença Apache 2.0 e parte proprietária, requisitos de RAM e portas, aviso do Swarm, instalação na ordem, domínio com HTTPS, porta 3000, backups e atualização.
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: Dokploy na VPS: publique apps no seu servidor Arte: Eleven Host
Dokploy na VPS é uma plataforma de deploy própria: você instala o Dokploy num servidor seu e publica aplicações e bancos por um painel web, sem depender de um serviço de terceiros. O núcleo é de código aberto, mas há recursos pagos.
Atualizado em 12/11/2026. Em 12/11/2026, a versão estável mais nova é a 0.31.1, publicada nesse mesmo dia. Os blocos marcados como exemplo não foram executados: confira cada um no seu servidor antes de usar.
O que é o Dokploy e qual é a licença
O Dokploy é descrito pelo projeto como uma alternativa de código aberto a Vercel, Netlify e Heroku. Ele usa Docker e Traefik e é mantido pela Dokploy Technology, Inc. Entre os recursos listados estão aplicações em várias linguagens (Node.js, PHP, Python, Go e outras), bancos de dados (MySQL, PostgreSQL, MongoDB, MariaDB e Redis), Docker Compose, monitoramento e notificações de deploy.
A licença é mista. O núcleo está sob a Apache License 2.0. A pasta /proprietary do repositório segue a Dokploy Source Available License (DSAL) 1.0, e o uso dela em produção exige um acordo comercial com a Dokploy. Desenvolvimento e teste dessa parte não exigem assinatura.
O núcleo do Dokploy é de código aberto (Apache 2.0) e gratuito para hospedar por conta própria; os recursos Enterprise ficam na parte proprietária, com chave de licença paga.
A documentação lista como recursos Enterprise o login único (SSO), o provisionamento SCIM, a autenticação de aplicações, os papéis personalizados, os logs de auditoria e a marca própria (whitelabel). O Dokploy Cloud, a versão hospedada pelo projeto, é pago por assinatura. A edição self-hosted, que você mesmo mantém, é a tratada aqui.
A versão ainda é 0.x, e a 0.31.1 trouxe cerca de 50 alterações, a maioria correções de segurança. Por isso, recomendamos instalar a versão mais recente e acompanhar as atualizações.
Para quem serve
A ferramenta atende quem quer publicar aplicações próprias, como uma API, um site em Node.js ou um sistema em PHP, num servidor que controla, com deploy por painel. É um exemplo de uso, sem promessa de resultado. Quem ainda não tem servidor pode começar pelo guia completo de servidor VPS, que explica o básico.
Requisitos oficiais
A documentação pede um servidor com pelo menos 2 GB de RAM e 30 GB de espaço em disco. Para estimar a memória das suas aplicações, o artigo Quanta RAM precisa uma VPS: como calcular a sua ajuda a montar a conta.
Os sistemas listados são Ubuntu (18.04, 20.04, 22.04, 23.10 e 24.04), Debian (10 a 12), Fedora 40 e CentOS (8 e 9). Parte dessa lista já saiu de suporte; recomendamos uma versão recente e ainda com suporte, como Ubuntu 24.04 LTS ou Debian 12. Confirme no atendimento da Eleven Host qual sistema a VPS oferece: atendimento em português do Brasil, pela área do cliente e por tickets.
As portas 80 (HTTP, usada pelo Traefik), 443 (HTTPS, usada pelo Traefik) e 3000 (interface web do Dokploy) precisam estar livres. A documentação avisa que a instalação falha se alguma estiver em uso. Portanto, não instale num servidor em que o Nginx ou o Apache já ocupam a 80 e a 443.
Atenção ao Swarm
O script oficial roda docker swarm leave --force e depois cria um Swarm novo, além da rede dokploy-network. Quem já usa Swarm no servidor perde essa configuração. Use uma VPS nova e dedicada ao Dokploy.
Para ver as VPS à venda, a loja da Eleven Host mostra os planos e os valores. 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 pelo script oficial, na ordem
Se o Docker faltar, o próprio script o instala. O comando da documentação, em 12/11/2026, é este (o README do projeto usa bash no lugar de sh):
curl -sSL https://dokploy.com/install.sh | sh
Segundo a documentação, o sudo zera o ambiente, então variáveis definidas antes dele não chegam ao script: passe-as na mesma linha ou use sudo -E. O script cria o Swarm, a rede, os serviços dokploy-postgres e dokploy, o contêiner dokploy-traefik e a pasta /etc/dokploy.
Quando terminar, confira os contêineres. Um exemplo de comando, a executar no seu servidor:
sudo docker ps
A documentação cita três nomes esperados: dokploy, dokploy-postgres e dokploy-traefik.
Primeiro acesso e conta de administrador
A documentação manda abrir http://IP-da-VPS:3000 no navegador e preencher os dados da conta de administrador. Ela também pede que o firewall do servidor permita o tráfego na porta 3000 para esse primeiro acesso.
Enquanto o domínio não está configurado, o painel fica acessível pelo IP e sem HTTPS, ou seja, a senha trafega sem criptografia. Recomendamos escolher uma senha longa e configurar o domínio no mesmo dia.
Domínio e HTTPS do painel
O Dokploy emite o certificado pelo Let's Encrypt, e o Traefik cuida do roteamento. Antes, aponte o DNS do domínio para o IP da VPS. A documentação destaca que o domínio precisa apontar para o servidor antes de ser cadastrado no Dokploy, ou o certificado não é gerado (a saída é recriar o domínio ou reiniciar o Traefik). O artigo O que é registro de domínio e como funciona explica o apontamento. Para domínios registrados conosco, o DNS gerenciado grátis na rede da Cloudflare fica no painel da área do cliente.
Com o DNS pronto, o ajuste do painel fica em Settings, Server: informe o domínio em Host e ative o HTTPS; confira os nomes das opções na versão que você instalou. Numa VPS com DNS direto, recomendamos escolher o Let's Encrypt como certificado. Nas aplicações, o certificado também pode ser personalizado ou nenhum; domínios traefik.me funcionam só em HTTP.
Fechar a porta 3000 e proteger o painel
Com o domínio e o HTTPS funcionando, a documentação manda remover o acesso por IP e porta. A ordem importa: antes de fechar, confirme que o painel abre pelo domínio. O comando oficial:
docker service update --publish-rm "published=3000,target=3000,mode=host" dokploy
O guia de produção da documentação pede manter a porta 3000 fechada para a internet, com o painel atrás do Traefik num domínio ou atrás de uma VPN. Ele recomenda também:
- firewall liberando só o SSH (22 ou a sua porta), 80 e 443. O Docker escreve direto no
iptablese ignora o UFW, então o UFW sozinho não protege as portas publicadas pelos contêineres. A documentação sugere oufw-dockerou o firewall do provedor; - SSH com chave (
PubkeyAuthentication yes), sem senha (PasswordAuthentication no) e sem login direto do root (PermitRootLogin no). Recomendamos ter antes outro usuário com acesso sudo e manter a sessão aberta até testar uma nova; - 2FA ou passkeys para cada pessoa com acesso ao painel, em Settings, Profile, guardando os códigos de recuperação. A documentação informa que não há opção para exigir 2FA de toda a organização;
- atualizações automáticas de segurança do sistema operacional, com o pacote
unattended-upgrades.
Publicar um aplicativo
Em linhas gerais, e com nomes de botões que podem mudar entre versões, o fluxo é este:
- criar um projeto no painel;
- adicionar uma aplicação e escolher a origem do código, como um repositório Git ou uma imagem Docker;
- definir o modo de construção e as variáveis de ambiente;
- em Domains, cadastrar o domínio da aplicação (com o DNS já apontado) e escolher o certificado;
- fazer o deploy e acompanhar os logs.
Quem tem um arquivo Docker Compose pode usá-lo: o suporte é nativo, e os domínios de Compose exigem um novo deploy para valer. Há também mais de 600 modelos prontos.
Bancos de dados e backups
Os bancos criados no Dokploy podem ter backup automático para um destino externo compatível com S3, configurado em Settings, Destinations. A agenda usa a sintaxe do cron, e o botão de teste faz um backup de verificação no bucket escolhido. O Dokploy não criptografa o arquivo: o guia de produção sugere ativar a criptografia no próprio bucket, com credenciais restritas a ele.
O Dokploy também faz backup de si mesmo, na área Web Server: o banco dokploy-postgres e a pasta /etc/dokploy, também com destino S3. Atenção: restaurar esse backup apaga o estado atual do banco e da pasta, e pode exigir novo login e reinício do Traefik. O guia de produção resume o cuidado: um backup que você nunca restaurou não é um backup, então teste a restauração.
Para as cópias do servidor em si, o artigo Backup da VPS: como fazer cópia automática trata da cópia automática da VPS. Se as aplicações guardam dados pessoais, a LGPD, a lei brasileira de proteção de dados, se aplica; um software não garante conformidade sozinho, e recomendamos falar com quem cuida do jurídico do negócio.
Atualização e disco cheio
No self-hosted a atualização é manual (no Cloud, é automática). A documentação indica reexecutar o script com o argumento de atualização. Um exemplo de comando, a conferir na documentação antes de usar:
curl -sSL https://dokploy.com/install.sh | sh -s update
Pelo que a documentação descreve, a rotina de atualização puxa a imagem mais nova do dokploy, mas não atualiza o Traefik, para evitar queda dos serviços. Recomendamos fazer um backup antes.
Outro ponto: com o disco cheio, o banco do Dokploy pode entrar em modo de recuperação e o painel deixa de abrir. A documentação sugere a limpeza com docker system prune -a, docker builder prune -a e docker image prune -a. Esses comandos apagam contêineres parados, redes, imagens e cache de construção sem uso; veja o que será removido antes de confirmar.
Endereço para os aplicativos
Uma aplicação com endereço e HTTPS próprios usa um nome de domínio, e esse nome vem do registro.
Domínios podem ser pesquisados e registrados na Eleven Host. Buscar domínio
Perguntas frequentes
O Dokploy é gratuito?
O núcleo self-hosted é gratuito. Os recursos Enterprise, como SSO e logs de auditoria, ficam na parte proprietária e dependem de licença paga.
O Dokploy é de código aberto?
O núcleo, sim, sob a Apache 2.0. A pasta /proprietary segue a DSAL 1.0, e o uso dela em produção exige acordo comercial.
Posso instalar numa VPS que já tem um site?
A instalação falha se as portas 80, 443 ou 3000 estiverem ocupadas, e o script desfaz um Swarm existente. Use uma VPS dedicada.
O Dokploy atualiza sozinho?
No self-hosted, não: a atualização é manual, e o Traefik não é atualizado pelo script.