Atualizar o Coolify e manter o servidor em ordem

Resposta rápida

Para atualizar o Coolify, configure antes o backup da instância em Settings > Backup e guarde o .env fora da VPS. Depois, em Settings > Updates, clique em Check Now e atualize; se preferir o terminal, rode o upgrade.sh oficial com a versão. Nunca rode o install.sh de novo para atualizar. A atualização não mexe nas aplicações, mas derruba os deploys em andamento. Na manutenção do dia a dia, mantenha a limpeza do Docker ligada, reinicie o proxy depois de mexer em certificados e, para crescer, ligue outra VPS por SSH.

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

Fazer o backup da instância antes de atualizar e saber o que ele não leva
Atualizar o Coolify pelo painel ou pelo comando oficial
Manter a limpeza do Docker sem perder os pontos de rollback
Reiniciar o proxy e ligar outra VPS ao Coolify por SSH

Antes de começar

Ser Owner ou Admin da equipe principal do Coolify
Acesso root à VPS por SSH, para o comando manual e o .env

Neste guia

Antes de atualizar: o backup da instância
Atualize o Coolify
Mantenha o servidor em ordem
Ligue outra VPS ao Coolify
Problemas comuns

Antes de atualizar: o backup da instância

O Coolify guarda projetos, recursos, configurações e histórico num banco interno. Esse banco tem backup próprio, separado do backup dos seus bancos de dados.

Clique em Configure Backup
No painel: SettingsBackup(Configurações › Backup)
Em Instance backup (backup da instância), clique em Configure Backup (configurar backup). O agendamento padrão é diário, e dá para mandar uma cópia para um armazenamento S3.
Dica Com o backup configurado, a opção de fazer backup antes de cada atualização passa a valer.

O backup da instância não leva o .env

O arquivo /data/coolify/source/.env guarda a APP_KEY, que cifra os segredos do banco do Coolify. Sem ele, o backup não abre. Guarde uma cópia à parte, como em segurança do Coolify. O backup também não leva os dados das aplicações, dos bancos nem dos volumes.

Atualize o Coolify

A atualização troca só o Coolify: não mexe nas aplicações, nos bancos nem nos serviços. Os deploys em andamento falham, e o painel fica fora por pouco tempo, em geral menos de um minuto, segundo a documentação.

Clique em Check Now
No painel: SettingsUpdates(Configurações › Atualizações)
Check Now (verificar agora) procura versão nova. Se houver, clique em Upgrade now (atualizar agora). Numa instalação nova pelo script oficial, o canal vem em Stable (estável) e Automatic updates (atualizações automáticas) vem em Enabled (ligado).
Dica Prefere escolher a hora? Mude Automatic updates para Disabled e atualize à mão, sem deploy rodando. Fique no canal Stable: o Nightly recebe menos testes e pode quebrar o painel.

curl -fsSL https://cdn.coollabs.io/coolify/upgrade.sh | bash -s 4.7.5

Atualização manual, na VPS, como root. Troque 4.7.5 pela versão que quer instalar, sem o v. Os registros ficam em /data/coolify/source/, nos arquivos upgrade-*.

Nunca rode o install.sh para atualizar

O comando de instalação refaz o dono e as permissões das pastas em /data/coolify. Para atualizar, use o painel ou o upgrade.sh.

Mantenha o servidor em ordem

Deixe a limpeza do Docker agendada
No painel: ServerslocalhostDocker cleanup(Servidores › a sua VPS › Limpeza do Docker)
Cada deploy deixa imagens e restos de build no disco. A limpeza roda todo dia à 0h (0 0 * * *), e Run Cleanup (limpar agora) roda na hora. A documentação recomenda manter o limite de uso do disco em 80%.
Reinicie o proxy depois de mexer em certificado
No painel: ServerslocalhostProxy(Servidores › a sua VPS › Proxy)
O proxy entrega os domínios às aplicações e cuida dos certificados. Depois de uma mudança de certificado, clique em Restart Proxy (reiniciar o proxy). Todos os sites passam por ele: o reinício corta o acesso por um instante.
1. Running: o proxy (Traefik) está rodando.
2. Restart Proxy: reinicia o proxy.
Confira a conexão com o servidor
No painel: Serverslocalhost(Servidores › a sua VPS)
A seção Connection (conexão) mostra o usuário e a porta do SSH e o Server timezone (fuso do servidor). Se o servidor aparecer como inacessível, Revalidate Connection (validar a conexão de novo), no alto da página, testa o SSH outra vez.

Não apague as imagens retidas

Em Advanced cleanup (limpeza avançada), deixe Keep retained images (manter imagens retidas): apagar as imagens antigas tira os pontos de rollback. Deixe também Keep unused volumes, porque um volume sem uso pode guardar dados de um contêiner parado.

Ligue outra VPS ao Coolify

Um Coolify só administra vários servidores. A VPS onde ele roda aparece como localhost e não pode ser removida. A conexão com a outra VPS é por SSH, como root, com a chave que o Coolify gerou na instalação.

Autorize a chave do Coolify na VPS nova
Copie a chave pública em Keys & Tokens > Private Keys e acrescente ao authorized_keys do root da VPS nova, com o comando abaixo.
Dica O SSH da VPS nova precisa aceitar chave (PubkeyAuthentication yes) e o root por chave (PermitRootLogin prohibit-password).

mkdir -p ~/.ssh && chmod 700 ~/.ssh
echo "CHAVE-PUBLICA-DO-COOLIFY" >> ~/.ssh/authorized_keys
chmod 600 ~/.ssh/authorized_keys

Na VPS nova, como root. Troque o texto entre aspas pela chave pública, que começa com ssh-ed25519.

Preencha o servidor e clique em Continue
No painel: Servers(Servidores)
Em Servers, adicione um servidor. O formulário Connect a server (ligar um servidor) pede o básico.
1. IP address or domain: O IP da VPS nova (aqui, 203.0.113.20).
2. Private key: A chave que o Coolify usa: localhost's key, a mesma da VPS principal.
3. Name: Um nome que você reconheça (aqui, vps-2).
4. Continue: Salva e segue para a validação.
Valide a conexão
Validate connection (validar conexão) testa o SSH, instala o Docker se faltar e sobe o proxy. Use uma VPS nova: a validação pode reiniciar o Docker e parar contêineres que já rodem nela.

Como saber se deu certo

Settings > Updates mostra Coolify is up to date, o backup da instância está agendado, a limpeza do Docker roda todo dia e, se você ligou outra VPS, ela aparece em Servers.

Problemas comuns

Um deploy falhou durante a atualização

Causa provável: A atualização derruba os deploys que estavam em andamento.
O que fazer: Rode o deploy de novo com Redeploy. Se as atualizações automáticas coincidem com os seus deploys, desligue e atualize à mão.

O painel não voltou depois da atualização

Causa provável: A atualização parou no meio ou um contêiner do Coolify não subiu.
O que fazer: Veja os arquivos upgrade-* em /data/coolify/source/ e siga problemas comuns, no item do painel inacessível.

A validação da VPS nova falha

Causa provável: A chave pública não está no authorized_keys do root, a porta do SSH está fechada ou o SSH não aceita o root por chave.
O que fazer: Confira o comando da chave, a porta do SSH no firewall da VPS nova e as duas opções do SSH, e valide de novo.

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

Próximo passoProblemas comuns do Coolify e como resolverOs erros que mais aparecem no Coolify, agrupados por aplicação, domínio e SSL, servidor e painel, com a causa provável e o que fazer.

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 Coolify Conhecer o VPS Assistido