𝗛𝗼𝘄 𝘁𝗼 𝗕𝗮𝗰𝗸𝘂𝗽 𝗮𝗻𝗱 𝗥𝗲𝘀𝘁𝗼𝗿𝗲 𝗖𝗼𝗼𝗹𝗶𝗳𝘆 𝗶𝗻 𝟭𝟮 𝗠𝗶𝗻𝘂𝘁𝗲𝘀

Your server feels safe today. You spent hours setting up Coolify. You host your own apps, databases, and blogs. You feel in control.

Then a disaster happens. Your VPS provider shuts down your region. You run a wrong command. The server dies.

If you have no backups, you lose everything. This guide prevents that. You can set up automated backups and a full restore in 12 minutes.

Step 1: Set up S3 Storage

Coolify needs a place to store backups. Use S3-compatible storage. Cloudflare R2 is a great choice because it has zero egress fees.

You need these details from your storage provider:

  • Endpoint
  • Region
  • Access Key
  • Secret Key
  • Bucket Name

In Coolify, go to the S3 Storage tab. Add your details and click Validate Connection.

Step 2: Enable Automated Backups

Go to Settings and then Backup.

  • Turn on S3 Backup.
  • Turn on Backup.
  • Select your S3 storage source.
  • Set the frequency to Daily.

Run one manual backup immediately. Check your S3 bucket to confirm the file exists.

Step 3: Save Your APP_KEY

This is the most important step. Coolify encrypts your data. If you lose this key, your backup is useless.

SSH into your server and run: cat /data/coolify/source/.env

Find the line starting with APP_KEY. Copy this value. Save it in a password manager. Do not skip this.

Step 4: Restore to a New Server

If your server dies, follow these steps on your new VPS:

  1. Install Coolify using the standard curl command.
  2. Download your .pgdump file from your S3 bucket to the new server.
  3. Run the restore command:

sudo docker exec -i coolify-db pg_restore --username coolify --verbose --dbname coolify < /path/to/your-backup.pgdump

You might see warnings about existing tables. Ignore them. It still works.

Step 5: Fix the 500 Error

After restoring, you might see a 500 error when clicking apps. This happens because the new server has a different APP_KEY.

To fix this:

  • Open your new .env file: nano /data/coolify/source/.env
  • Add this line: APP_PREVIOUS_KEYS=base64:your-old-app-key
  • Save and restart Coolify using the install script.

Now your old data is readable again.

Summary Checklist:

  • Set up S3 storage.
  • Enable daily backups.
  • Save your APP_KEY safely.
  • Test a manual backup.

Self-hosting gives you control. Backups give you peace of mind.

Como fazer Backup e Restauração do Coolify em 12 Minutos Antes que seu Servidor Morra em uma Noite de Sexta-feira

Todos nós já passamos por isso. É noite de sexta-feira, você está prestes a relaxar e, de repente... seu servidor cai. E o pior? Você não tem um backup recente.

Se você usa o Coolify, sabe o quanto ele é incrível para gerenciar seus serviços auto-hospedados. Mas, como qualquer servidor, ele não é imune a falhas. Por isso, ter uma estratégia de backup é essencial.

Neste guia, vou mostrar como fazer o backup e a restauração do Coolify de forma rápida e eficiente.

O que o Coolify armazena?

O Coolify armazena quase todas as suas configurações, dados de bancos de dados e informações de containers no diretório:

/data/coolify

Se você tiver volumes do Docker personalizados em outros locais, certifique-se de incluí-los também. Mas, para a maioria dos usuários, o diretório /data/coolify é o coração de tudo.

Passo 1: Criando o Backup

O método mais simples e eficaz é criar um arquivo compactado de todo o diretório do Coolify.

Conecte-se ao seu servidor via SSH e execute o seguinte comando:

sudo tar -cvzf coolify-backup.tar.gz /data/coolify

O que este comando faz?

  • sudo: Executa com privilégios de superusuário.
  • tar: A ferramenta de arquivamento.
  • -c: Cria um novo arquivo.
  • -v: Modo "verbose" (mostra os arquivos sendo processados).
  • -z: Compacta o arquivo usando gzip.
  • -f: Especifica o nome do arquivo de saída.
  • coolify-backup.tar.gz: O nome do seu arquivo de backup.
  • /data/coolify: O diretório que você deseja copiar.

Após a conclusão, você terá um arquivo chamado coolify-backup.tar.gz no seu diretório atual.

Passo 2: Movendo o Backup para um Local Seguro

Nunca guarde seu backup apenas no mesmo servidor que você está protegendo. Se o servidor morrer, o backup morrerá com ele.

Use scp ou rsync para mover o arquivo para sua máquina local ou para um serviço de armazenamento em nuvem (como AWS S3, Google Drive ou Dropbox).

Exemplo usando scp para sua máquina local:

scp user@seu-ip-do-servidor:/caminho/para/coolify-backup.tar.gz ~/Downloads/

Passo 3: Restaurando o Coolify em um Novo Servidor

Agora, imagine o pior aconteceu. Seu servidor morreu e você precisa subir tudo em uma nova instância.

  1. Instale o Coolify no novo servidor: Siga as instruções oficiais de instalação do Coolify para ter o ambiente pronto.

  2. Pare o Coolify (se necessário): Para evitar corrupção de dados, é recomendável que o Coolify não esteja rodando durante a restauração.

  3. Transfira o backup para o novo servidor:

scp ~/Downloads/coolify-backup.tar.gz user@novo-ip-do-servidor:/home/user/
  1. Extraia o backup:

Conecte-se ao novo servidor e execute:

sudo tar -xvzf coolify-backup.tar.gz -C /

O que este comando faz?

  • -x: Extrai o conteúdo do arquivo.
  • -v: Modo "verbose".
  • -z: Descompacta usando gzip.
  • -f: Especifica o arquivo de entrada.
  • -C /: Diz ao tar para extrair o conteúdo no diretório raiz, o que restaurará a estrutura /data/coolify corretamente.
  1. Reinicie o servidor/serviços:

Após a extração, reinicie o seu servidor ou os containers do Coolify para que ele reconheça os dados restaurados.

Conclusão

E pronto! Em menos de 12 minutos, você pode ter todo o seu ecossistema Coolify de volta ao funcionamento.

Dica de ouro: Não espere o desastre acontecer. Automatize esse processo! Você pode criar um script simples e agendá-lo usando um cron job para que o backup seja feito diariamente e enviado para a nuvem automaticamente.

Agora você pode aproveitar sua noite de sexta-feira com tranquilidade. 🍻