Como configurar um ambiente com Docker Compose no seu VPS da GeHost
Oi, eu sou a Sensei da GeHost 👋 Hoje vou te guiar, passo a passo, para colocar o Docker Compose rodando no seu VPS. Não se preocupe se você nunca mexeu com isso antes — vamos com calma, um comando de cada vez, e no final você vai ter seus containers rodando tranquilamente. Bora lá!
💡 Antes de começar: este guia é para quem já tem (ou vai contratar) um VPS com a GeHost, com acesso via SSH. Se você tem um plano de hospedagem compartilhada (cPanel), o Docker não roda por lá — nesse caso, fale com a nossa equipe pelo painel.gehost.com.br para saber como migrar ou contratar um VPS.
O que é o Docker Compose, afinal?
Pense no Docker como "caixinhas" isoladas onde cada aplicação roda sozinha, sem bagunçar o resto do servidor. O Docker Compose é a ferramenta que te ajuda a organizar várias dessas caixinhas juntas — por exemplo, seu site, o banco de dados e um cache — tudo descrito num único arquivo de texto, fácil de subir, derrubar e recriar quando quiser.
Passo 1 — Acesse seu VPS via SSH
Você vai precisar do IP do seu servidor e das credenciais de acesso, que ficam disponíveis no seu painel do cliente. Com um terminal (no Windows pode usar o PowerShell ou o PuTTY; no Mac/Linux, o Terminal), conecte assim:
ssh usuario@SEU-IP-AQUI
Troque usuario e SEU-IP-AQUI pelos dados que estão no seu painel. Se for a primeira vez que você acessa, o sistema pode pedir para confirmar a conexão — pode digitar "yes" tranquilamente.
Passo 2 — Instale o Docker
A maioria dos VPS Linux (Ubuntu/Debian) permite instalar o Docker com o script oficial. Rode os comandos abaixo, um por vez:
- Atualize os pacotes do sistema:
sudo apt update && sudo apt upgrade -y
- Baixe e execute o instalador oficial do Docker:
curl -fsSL https://get.docker.com -o get-docker.sh sudo sh get-docker.sh
- Confirme que instalou certinho:
docker --version
💡 Dica da Sensei: se aparecer a versão do Docker na tela, deu tudo certo! Se der algum erro, pode ser que seu VPS use outra distribuição Linux — nesse caso, chama o suporte da GeHost pelo painel que a gente te orienta.
Passo 3 — Confirme que o Docker Compose está disponível
Nas versões atuais do Docker, o Compose já vem integrado como um "plugin" (usa-se docker compose, com espaço, em vez de docker-compose). Teste com:
docker compose version
Se aparecer a versão, está tudo pronto para o próximo passo.
Passo 4 — Crie a pasta do seu projeto
- Crie uma pasta para organizar seus arquivos:
mkdir meu-projeto && cd meu-projeto
- Dentro dela, crie o arquivo principal que descreve seus containers:
nano docker-compose.yml
Passo 5 — Escreva seu arquivo docker-compose.yml
Esse arquivo é o "mapa" do seu ambiente: nele você descreve quais serviços (containers) vão rodar. Aqui vai um exemplo simples, com um site e um banco de dados MySQL, só para você entender a lógica:
version: "3.9"
services:
site:
image: nginx:latest
ports:
- "8080:80"
volumes:
- ./html:/usr/share/nginx/html
restart: unless-stopped
banco:
image: mysql:8
environment:
MYSQL_ROOT_PASSWORD: escolha-uma-senha-forte
MYSQL_DATABASE: meubanco
volumes:
- dados_mysql:/var/lib/mysql
restart: unless-stopped
volumes:
dados_mysql:
Salve o arquivo (no nano, é Ctrl+O, Enter, depois Ctrl+X para sair).
💡 Dica da Sensei: troque sempre senhas de exemplo por senhas fortes e únicas — nunca deixe algo como "123456" ou "escolha-uma-senha-forte" (literalmente) no seu arquivo de verdade!
Passo 6 — Suba os containers
Com o arquivo salvo, dentro da mesma pasta, rode:
docker compose up -d
O -d significa "modo silencioso" (detached) — os containers ficam rodando em segundo plano e você recupera o terminal na hora. O Docker vai baixar as imagens necessárias (pode levar alguns minutos na primeira vez) e iniciar tudo.
Passo 7 — Confira se está tudo funcionando
- Ver os containers ativos:
docker compose ps
- Acompanhar os logs em tempo real:
docker compose logs -f
- Testar seu site: abra no navegador
http://SEU-IP:8080(troque pelo IP do seu VPS).
Comandos úteis do dia a dia
- Parar tudo:
docker compose stop - Parar e remover os containers (os dados em volumes continuam salvos):
docker compose down - Reiniciar depois de editar o docker-compose.yml:
docker compose up -d --build - Ver quanto espaço o Docker está usando:
docker system df
💡 Dica da Sensei: evite rodar docker system prune -a sem entender o que faz — esse comando apaga imagens e containers parados de uma vez. Se tiver dúvida, é sempre mais seguro perguntar antes de limpar algo no servidor.
Precisa de ajuda?
Se travar em algum passo, ou quiser uma mãozinha para planejar o ambiente ideal para o seu projeto (recursos de CPU, memória, disco), é só chamar a gente pelo painel do cliente. A equipe da GeHost está aqui para te ajudar a colocar tudo no ar com tranquilidade. Bons deploys! 🚀