Como Instalar o Dokploy na sua VPS e Configurar um Domínio com SSL

Se você trabalha com Docker e precisa de uma maneira simples de gerenciar suas aplicações, o Dokploy pode facilitar bastante o seu trabalho.

Com ele, você consegue instalar aplicações, gerenciar bancos de dados, acompanhar contêineres e configurar domínios diretamente pelo navegador.

Neste tutorial, vamos aprender a instalar o Dokploy em uma VPS, acessar seu painel administrativo e configurar um domínio próprio com certificado SSL.

A melhor parte é que não precisamos fazer toda a configuração manualmente. O próprio instalador prepara boa parte do ambiente para nós.

O que é o Dokploy?

O Dokploy é uma plataforma gratuita e de código aberto para gerenciamento e publicação de aplicações.

Ele utiliza tecnologias como Docker e Docker Swarm para organizar e executar seus serviços.

Com o Dokploy, você pode:

• Instalar aplicações utilizando templates.
• Gerenciar contêineres Docker.
• Criar e administrar bancos de dados.
• Configurar domínios e certificados SSL.
• Acompanhar o consumo de CPU e memória.
• Gerenciar volumes e imagens Docker.
• Publicar aplicações através de uma interface visual.

Na prática, ele funciona como um painel de controle para administrar suas aplicações na VPS.

1. O que você precisa para instalar o Dokploy?

Antes de começar, precisamos de algumas coisas.

Uma VPS

Você precisa de um servidor VPS com acesso administrativo.

Pode ser contratado em empresas como Hostinger, Hetzner, Contabo ou qualquer outro provedor de sua preferência.

Para este tutorial, vamos utilizar uma VPS com Ubuntu 24.04.

É importante utilizar uma distribuição compatível com a versão atual do Dokploy. Consulte a documentação oficial antes de escolher o sistema operacional.

Um domínio próprio

Também vamos precisar de um domínio para configurar o acesso ao painel.

Você pode utilizar um domínio registrado em qualquer empresa.

Neste exemplo, vamos utilizar o Cloudflare para administrar os registros DNS.

O Cloudflare não é obrigatório. Você pode fazer o apontamento diretamente pelo provedor onde seu domínio está registrado.

2. Escolhendo o sistema operacional da VPS

Durante a contratação do servidor, você precisará escolher qual sistema operacional será instalado.

No vídeo, utilizamos o Ubuntu 24.04.

Outras versões e distribuições podem ser compatíveis, mas é importante conferir a lista disponível na documentação do Dokploy.

Evite escolher uma versão apenas por ser mais recente. O importante é garantir que ela seja suportada.

Outro detalhe importante é utilizar um servidor limpo, sem outras aplicações instaladas.

Isso evita conflitos durante a instalação do Docker e dos demais serviços.

3. Conferindo os requisitos do Dokploy

Antes de instalar, acesse a documentação oficial:

Documentação do Dokploy

Confira principalmente:

• Sistemas operacionais compatíveis.
• Requisitos do servidor.
• Portas que precisam estar liberadas.
• Procedimento de instalação.

No exemplo do tutorial, precisamos verificar três portas importantes:

Porta	Finalidade
80	Acesso HTTP
443	Acesso HTTPS
3000	Painel administrativo

Essas portas precisam estar liberadas no firewall do servidor e nas regras de rede do provedor, quando aplicável.

A porta 3000 será utilizada inicialmente para acessar o painel do Dokploy.

4. Instalando o Dokploy na VPS

Agora vamos começar a instalação.

Primeiro, acesse sua VPS utilizando SSH.

Você pode utilizar o terminal do Linux, macOS ou um programa como PuTTY no Windows.

O acesso normalmente é feito com:

ssh root@IP_DA_SUA_VPS

Substitua IP_DA_SUA_VPS pelo endereço IP do seu servidor.

Depois de acessar, você estará dentro do terminal da VPS.

Executando o instalador

Com o servidor preparado, acesse a documentação oficial do Dokploy e copie o comando de instalação disponibilizado na página.

Execute o comando no terminal.

O instalador será responsável por preparar o ambiente e instalar os componentes necessários.

Durante o processo, ele fará automaticamente algumas tarefas:

1. Verificar o sistema operacional.
2. Preparar o ambiente.
3. Instalar ou configurar o Docker.
4. Inicializar o Docker Swarm.
5. Instalar os serviços necessários para o Dokploy.

Aguarde até que o processo seja concluído.

Importante: execute o instalador oficial somente em uma VPS preparada para essa finalidade. Não utilize comandos de instalação de fontes desconhecidas.

5. Entendendo o Docker Swarm

Durante a instalação, o Dokploy também prepara o Docker Swarm.

Mas o que significa isso?

O Docker Swarm é uma ferramenta que permite organizar e gerenciar contêineres Docker.

Com ele, podemos trabalhar com serviços, redes e réplicas de aplicações.

O mais interessante é que o Dokploy já prepara essa estrutura automaticamente.

Você não precisa configurar tudo manualmente para começar a utilizar a plataforma.

Se futuramente precisar trabalhar com mais servidores, também poderá utilizar os recursos de gerenciamento de nós do Docker Swarm.

6. Acessando o painel do Dokploy

Quando a instalação terminar, o instalador apresentará o endereço de acesso ao painel.

Normalmente, o acesso inicial será feito utilizando:

http://IP_DA_SUA_VPS:3000

Substitua IP_DA_SUA_VPS pelo endereço IP do seu servidor.

Abra esse endereço no navegador.

Se não conseguir acessar, confira se a porta 3000 está liberada no firewall.

Criando sua conta administrativa

No primeiro acesso, o Dokploy solicitará o cadastro da conta administrativa.

Preencha os dados solicitados e finalize o registro.

Depois disso, você poderá acessar o painel utilizando seu e-mail e senha.

Pronto! Agora já temos o Dokploy instalado e funcionando.

7. Conhecendo o painel do Dokploy

Ao entrar no painel, você encontrará uma interface com diversas opções para gerenciar seu servidor.

Entre os principais recursos estão:

Projects

Permite organizar suas aplicações em projetos.

Por exemplo, você pode criar um projeto chamado Aprenda na Web e colocar dentro dele todas as aplicações relacionadas ao seu site.

Services

É onde você gerencia os serviços e aplicações instalados.

Deployments

Permite acompanhar as publicações realizadas e verificar o resultado de cada Deploy.

Docker

Nessa área você encontra informações relacionadas ao ambiente Docker.

É possível visualizar:

• Contêineres.
• Imagens.
• Volumes.
• Nós do Docker Swarm.

Traefik

O Dokploy utiliza o Traefik para gerenciar o acesso às aplicações e configurar o roteamento de domínios.

Isso facilita bastante o trabalho, pois não precisamos configurar manualmente todo o proxy reverso para cada aplicação.

8. Configurando um domínio próprio para o Dokploy

Agora vamos configurar um domínio para acessar o painel sem precisar utilizar o endereço IP e a porta 3000.

No exemplo, vamos utilizar um subdomínio:

dokploy.seudominio.com.br

Primeiro, precisamos fazer o apontamento DNS.

Criando o registro DNS no Cloudflare

Acesse sua conta do Cloudflare e selecione o domínio que deseja utilizar.

Depois, entre em:

DNS → Records → Add record

Crie um registro com as seguintes informações:

Campo	Valor
Type	A
Name	dokploy
IPv4 address	IP da sua VPS
Proxy status	DNS Only

O registro ficará semelhante a este:

Tipo: A
Nome: dokploy
Conteúdo: IP_DA_SUA_VPS

Substitua o IP pelo endereço IPv4 do seu servidor.

Neste primeiro momento, deixe a nuvem do Cloudflare desativada, utilizando o modo DNS Only.

Salve o registro.

Agora precisamos configurar esse domínio dentro do Dokploy.

9. Configurando o domínio e o certificado SSL

Volte ao painel do Dokploy.

Acesse:

Settings → Web Server

Nessa área você encontrará as configurações relacionadas ao servidor web.

Informe o subdomínio criado anteriormente:

dokploy.seudominio.com.br

Depois, informe um endereço de e-mail válido para utilizar na emissão do certificado.

Habilite a opção de certificado SSL e selecione o Let's Encrypt.

O Let's Encrypt é uma autoridade certificadora que permite emitir certificados HTTPS gratuitamente.

Depois de preencher as informações, clique em Save.

O Dokploy utilizará o Traefik para configurar o acesso seguro ao painel.

Aguarde a configuração ser concluída.

10. Testando o acesso HTTPS

Agora chegou a hora de testar.

Abra uma nova aba no navegador e acesse:

https://dokploy.seudominio.com.br

Se tudo estiver configurado corretamente, você verá o painel do Dokploy utilizando HTTPS.

Faça login com o e-mail e a senha cadastrados anteriormente.

Pronto! Agora você já consegue acessar seu painel utilizando um domínio próprio e uma conexão segura.

Posso fechar a porta 3000?

Depois de confirmar que o acesso pelo domínio está funcionando, você pode restringir a porta 3000 no firewall.

No tutorial, a ideia é deixar o acesso administrativo disponível pelo domínio configurado, utilizando HTTPS.

Antes de bloquear a porta, confirme que o acesso pelo domínio está funcionando corretamente.

Também é importante lembrar que restringir a porta 3000 não substitui outras medidas de segurança do servidor.

Conclusão

Como você viu, instalar o Dokploy em uma VPS é um processo relativamente simples.

Com um único instalador, conseguimos preparar o ambiente Docker, inicializar o Docker Swarm e colocar o painel administrativo no ar.

Depois, configuramos um domínio próprio utilizando o Cloudflare e habilitamos o certificado SSL com Let's Encrypt.

Agora você tem uma plataforma para gerenciar suas aplicações e bancos de dados diretamente pelo navegador.

No próximo tutorial, vamos utilizar o Dokploy para instalar o N8N e mostrar como publicar uma aplicação utilizando os templates disponíveis.

Se você trabalha com Docker, VPS e automações, o Dokploy pode ser uma excelente ferramenta para simplificar seu dia a dia.