Como Instalar o Dokploy no Ubuntu 24.04 (Guia Completo e Atualizado)

O Dokploy é uma plataforma moderna para deploy de aplicações, alternativa leve e poderosa ao CapRover, Dokku ou Portainer. Ele permite gerenciar projetos, containers, redes e bancos de dados de forma simples, com interface intuitiva e integração direta com GitHub e pipelines automáticas.

Neste guia, você aprenderá passo a passo como instalar o Dokploy em uma VPS Ubuntu 24.04, desde a preparação do servidor até o acesso ao painel.

Pré-requisitos

Antes de começar, você precisa de:

• Uma VPS Ubuntu 24.04 atualizada
• Acesso com usuário root ou com permissões sudo
• Docker e Docker Compose instalados
• Porta 3000 liberada no firewall (ou configurada no painel da sua VPS)

1️⃣ Atualize o sistema
Sempre comece atualizando os pacotes do sistema:
sudo apt update && sudo apt upgrade -y

2️⃣ Instale o Docker (caso ainda não tenha)
Faça a instalação do Docker Engine e Docker Compose:

sudo apt install -y ca-certificates curl gnupg lsb-release
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

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

Verifique se o Docker está funcionando:
sudo docker --version

3️⃣ Crie o diretório do Dokploy

Escolha onde quer instalar (ex.: /opt/dokploy):
sudo mkdir -p /opt/dokploy
cd /opt/dokploy

4️⃣ Baixe o arquivo docker-compose do Dokploy
O projeto disponibiliza um arquivo oficial:
sudo curl -L https://dokploy.com/docker-compose.yml -o docker-compose.yml

5️⃣ Inicie o Dokploy
Agora basta subir os containers:
sudo docker compose up -d

Isso irá iniciar:

• Backend do Dokploy
• Frontend
• Banco interno
• Serviços auxiliares

6️⃣ Verifique se está rodando corretamente
sudo docker compose ps
Deve aparecer algo como:

dokploy-api     running
dokploy-web     running
postgres        running

7️⃣ Acesse o painel do Dokploy
Após a instalação, abra no navegador:
http://SEU_IP:3000

Exemplo:
http://192.168.0.10:3000

Conclusão

O Dokploy se destaca por ser leve, rápido e muito mais simples de gerenciar do que soluções tradicionais. Com esse guia, seu ambiente já está pronto para:

1. Deploy de aplicações Node, PHP, Python, Go etc.
2. Deploy automático via GitHub
3. Criar containers no modo manual ou template
4. Gerenciar bancos (PostgreSQL, MySQL, Redis)
5. Configurar domínios e SSL