Coolify é uma alternativa de código aberto e auto-hospedada ao Heroku e ao Vercel, que permite gerenciar seus servidores, aplicações e bancos de dados com facilidade.
O painel intuitivo do Coolify torna a auto-hospedagem muito fácil. Você tem controle total sobre sua infraestrutura, deploys automatizados do GitHub e mantém os custos com a nuvem baixos.
Neste guia, mostraremos passo a passo como configurar o Coolify, pré-configurar sua conta de administrador e ajustar tudo o que você precisa saber.
Embora o Coolify seja leve, o consumo de recursos pode aumentar bastante dependendo do número de aplicações implantadas, builds do Docker e bancos de dados em execução. Recomendamos os seguintes requisitos de hardware para usar o Coolify no seu Servidor VPS/servidor dedicado:
| Hardware | Mínimo | Recomendado |
|---|---|---|
| CPU | 2 núcleos vCPU | 4 núcleos vCPU |
| RAM | 2 GB | 4 GB+ |
| Espaço em disco | 30 GB | 50 GB+ |
Antes de instalar o Coolify, conecte-se ao servidor e verifique se o sistema operacional está atualizado. Você precisa se conectar por SSH com acesso root. Se precisar de ajuda, consulte nosso guia de primeiro acesso via SSH.
Autenticação por chave SSH
Recomendamos fortemente configurar a autenticação por chave SSH em vez de usar uma senha. Saiba como fazer isso em nosso guia de configuração de chave SSH.
Depois de se conectar ao servidor, atualize os pacotes do sistema e instale o curl, necessário para baixar o script de instalação do Coolify:
sudo apt update && sudo apt upgrade -y && sudo apt install curl -y
O Coolify aplica regras de segurança rigorosas à sua conta de administrador. Antes de executar o script de instalação, prepare as credenciais do usuário root de acordo com estes requisitos:
- Nome de usuário
- Pelo menos 3 caracteres
- No máximo 255 caracteres
- São permitidos apenas letras, números, espaços, sublinhados e hífens
- E-mail
- Deve ser um endereço de e-mail válido
- Deve ter um registro DNS válido
- No máximo 255 caracteres
- Senha
- Pelo menos 8 caracteres
- Deve conter letras maiúsculas e minúsculas
- Pelo menos um número
- Pelo menos um caractere especial
- Não pode ser uma senha comum ou comprometida
O Coolify oferece um script de instalação rápido e automatizado. Para proteger a instalação, definimos os dados do administrador root usando variáveis de ambiente. Isso impede o acesso não autorizado durante a configuração.
Execute o comando a seguir e substitua o nome de usuário, o e-mail e a senha por credenciais seguras:
env ROOT_USERNAME=zaphosting ROOT_USER_EMAIL=info@zap-hosting.com ROOT_USER_PASSWORD=zaphosting bash -c 'curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash'
Código aberto
Você encontra o código-fonte do script de instalação no repositório oficial do Coolify
O script instala o Docker automaticamente, configura as redes necessárias e configura os contêineres do Coolify. Isso pode levar alguns minutos, dependendo do hardware do servidor.
Após a instalação, você pode abrir o painel no navegador. Digite o endereço IP do servidor com a porta 8000: http://[deine_server_ip]:8000
Como você já informou suas credenciais no comando de instalação, será direcionado diretamente à tela de login, e não ao assistente de configuração.
Entre usando o e-mail e a senha informados no terminal.
Após fazer login, configure seu próprio domínio primeiro. O acesso pelo endereço IP (http://[deine_server_ip]:8000) não é seguro.
Com um domínio, o Coolify pode criar automaticamente certificados SSL gratuitos para o painel e todas as aplicações futuras.
Acesse o gerenciamento de DNS do seu provedor de domínio e adicione dois novos registros A apontando para o seu servidor. Se o seu domínio estiver registrado na ZAP-Hosting, consulte nosso guia de registros de domínio para configurá-los:
| Nome / Host | Tipo | Valor | TTL |
|---|---|---|---|
@ | A | [deine_server_ip] | Auto / Baixo |
* | A | [deine_server_ip] | Auto / Baixo |
Roteamento DNS
- O registro
@permite que o Coolify use o domínio raiz - O registro curinga
*permite que o Coolify roteie automaticamente todas as novas subdomínios (por exemplo,api.[deine_domain]), sem que você precise criar registros DNS para cada projeto.
Para proteger sua instância do Coolify com um certificado SSL, você deve atribuir um domínio a ela. No menu à esquerda, acesse Configurações e localize o campo Instance Domain. Insira seu domínio com https:// (por exemplo, https://coolify.[deine_domain]). Salve a alteração.
