Hospedagem Segura — página inicial
Área do clienteContatoVer planos

Primeiros passos

Como instalar o Coolify na VPS

Requisitos, acesso por SSH, o comando oficial, a janela de 10 minutos para a primeira conta e a cópia do arquivo .env.

  • Nível: Iniciante
  • Tempo: cerca de 10 minutos
  • Atualizado em 12/11/2026
  • Por equipe técnica da Hospedagem Segura

Resposta rápida

Para instalar o Coolify, entre na VPS por SSH como root e rode o script oficial: curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash. Ele instala o Docker, cria as pastas em /data/coolify e sobe o painel. No fim, aparece o endereço http://IP-da-VPS:8000. Abra esse endereço logo e crie a conta de administrador: o Coolify aceita a primeira conta só nos 10 minutos depois que ele inicia.

O painel do Coolify é em inglês. Neste manual, os botões aparecem como estão na tela, em negrito, com a tradução ao lado. Dúvida com algum termo? Veja o glossário do Coolify em português.

Você vai aprender

  • Conferir se a VPS atende aos requisitos do Coolify
  • Entrar na VPS por SSH como root
  • Rodar o script oficial e entender o que ele instala
  • Abrir o painel na porta 8000 a tempo de criar a primeira conta
  • Guardar uma cópia do arquivo .env, que tem a APP_KEY

Antes de começar

  • Uma VPS Linux nova, com Ubuntu LTS ou Debian
  • O IPv4 da VPS e o acesso root por SSH
Neste guia
  1. Antes de começar
  2. Entre na VPS por SSH
  3. Rode o script oficial
  4. Confira o fim da instalação
  5. Guarde uma cópia do arquivo .env
  6. Abra o painel
  7. Problemas comuns

Antes de começar

O Coolify muda bastante o servidor: instala o Docker, publica portas e assume as portas 80 e 443 com o proxy. Por isso a documentação recomenda um servidor novo, sem outros serviços, para evitar conflito.

O que o Coolify pede do servidor
ItemRequisito
Processador2 núcleos, no mínimo
Memória2 GB, no mínimo, só para o Coolify. Aplicações, bancos e builds somam a isso
Disco10 GB livres, no mínimo, mais imagens, volumes e backups. O script avisa abaixo de 30 GB no total
Arquiteturaamd64 ou arm64
SistemaUbuntu LTS ou Debian. Ubuntu fora do LTS pede a instalação manual
Acessoroot, ou um usuário com sudo

Na VPS da Hospedagem Segura, o plano de 4 GB (2 vCPU, 50 GB NVMe) é o ponto de partida. Para vários projetos ou bancos maiores, comece pelo de 8 GB (4 vCPU, 100 GB NVMe).

Entre na VPS por SSH

No Windows, abra o PowerShell. No Mac ou no Linux, abra o Terminal. Rode o comando abaixo, trocando 203.0.113.10 pelo IPv4 da sua VPS:

ssh root@203.0.113.10
Na primeira conexão, confirme a pergunta sobre o servidor com yes.

Entrou com um usuário que tem sudo, e não com o root? Rode sudo -i para virar root antes do próximo passo.

Rode o script oficial

O instalador oficial do Coolify faz tudo sozinho. Cole o comando no terminal da VPS:

curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash
Rode como root. O script para com um aviso se não tiver permissão.

Enquanto ele roda, a tela mostra cada etapa. É isto que o script faz na sua VPS:

  1. Instala os pacotes de que precisa: curl, wget, git, jq e openssl.
  2. Confere a configuração do servidor SSH (OpenSSH).
  3. Instala o Docker Engine e configura a rotação dos logs.
  4. Cria as pastas em /data/coolify e baixa os arquivos do Coolify.
  5. Cria as variáveis de ambiente, no arquivo /data/coolify/source/.env.
  6. Gera a chave SSH que o Coolify usa para entrar na própria VPS, o servidor localhost.
  7. Baixa as imagens do Coolify e inicia o painel.

Confira o fim da instalação

  1. Copie o endereço do painel

    Quando aparece Coolify is ready!, o script mostra em Public IPv4 o endereço do painel, com o IP da sua VPS e a porta 8000. Logo abaixo vêm dois avisos: criar a conta em 10 minutos e guardar o arquivo .env.

Crie a conta de administrador em até 10 minutos

O Coolify aceita a primeira conta só nos 10 minutos depois que ele inicia. Quem abrir a tela de cadastro primeiro vira administrador, com acesso root ao servidor. Abra o painel logo depois da instalação. Se aparecer Setup window closed (janela de cadastro fechada), rode docker restart coolify na VPS e recarregue a página.
Quer instalar já com a conta de administrador criada?

Assim a tela de cadastro nunca fica aberta. Passe o nome, o e-mail e a senha nas variáveis ROOT_USERNAME, ROOT_USER_EMAIL e ROOT_USER_PASSWORD. A senha precisa de 8 caracteres ou mais, com maiúscula, minúscula, número e símbolo. O script exige o e-mail e a senha juntos.

env ROOT_USERNAME=admin \
  ROOT_USER_EMAIL=voce@example.com \
  ROOT_USER_PASSWORD='TROQUE-PELA-SUA-SENHA' \
  bash -c 'curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash'
Troque o e-mail e a senha pelos seus antes de rodar.

Guarde uma cópia do arquivo .env

O arquivo /data/coolify/source/.env tem a APP_KEY, que o Coolify usa para cifrar dados do banco interno. Sem ela, não dá para restaurar o Coolify a partir de um backup, e o backup do painel não leva esse arquivo. Guarde a cópia fora da VPS, num lugar seguro, como um gerenciador de senhas.

scp root@203.0.113.10:/data/coolify/source/.env ./coolify-env-copia
Rode no seu computador, no PowerShell ou no Terminal, e não na VPS.

Abra o painel

  1. Abra o endereço no navegador

    Abra http://203.0.113.10:8000, com o IP da sua VPS. Aparece o cadastro da conta de administrador, com o botão Create Account (criar conta). Siga para o primeiro acesso.

Sem HTTPS por enquanto

O endereço com IP e porta 8000 não tem criptografia. Use-o só para a configuração inicial e, em seguida, coloque o painel no seu domínio, com HTTPS.

Como saber se deu certo

O script termina com Coolify is ready!, o endereço http://IP-da-VPS:8000 abre a tela de cadastro e a cópia do .env está guardada fora da VPS.

Problemas comuns

O script para com Please run this script as root or with sudo
Causa provável
Você está num usuário comum, sem permissão de administrador.
O que fazer
Entre como root (ssh root@203.0.113.10) ou rode sudo -i antes do comando.
A tela de cadastro mostra Setup window closed
Causa provável
Passaram os 10 minutos em que o Coolify aceita a primeira conta.
O que fazer
Rode docker restart coolify na VPS, recarregue a página e crie a conta logo.
O endereço com a porta 8000 não abre
Causa provável
A instalação não terminou, o contêiner do Coolify parou ou um firewall bloqueia a porta 8000.
O que fazer
Confira se o script terminou com Coolify is ready!. Rode docker ps e veja se o contêiner coolify está de pé; se não, docker restart coolify. O log da instalação fica em /data/coolify/source/.

Não resolveu? Veja os problemas comuns do Coolify ou abra um chamado na central do cliente.

Próximo passoPrimeiro acesso ao Coolify: conta de administrador e painelO cadastro do administrador, as três etapas das boas-vindas, o menu lateral item por item e o cadastro fechado depois.

Fontes e documentação oficial

Coolify é um software de código aberto mantido pelo próprio projeto. Este manual é da Hospedagem Segura, para quem roda o Coolify nas nossas VPS, e foi conferido na versão 4.7.5.

Continue aprendendo

Ver todos os guias do Manual do Coolify

Rode o Coolify numa VPS da Hospedagem Segura

VPS Linux com acesso root, disco NVMe e IPv4 dedicado a partir de R$ 69,90/mês. Prefere a VPS pronta? No VPS Assistido, o Coolify vem instalado, com o painel no seu domínio, e a equipe ajuda no dia a dia.

Ver VPS para CoolifyConhecer o VPS Assistido