Como configurar um ambiente com Docker Compose no seu VPS da GeHost imprimir

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:

1. Atualize os pacotes do sistema:

   sudo apt update && sudo apt upgrade -y

2. Baixe e execute o instalador oficial do Docker:

   curl -fsSL https://get.docker.com -o get-docker.sh
   sudo sh get-docker.sh

3. 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

1. Crie uma pasta para organizar seus arquivos:

   mkdir meu-projeto && cd meu-projeto

2. 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! 🚀