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

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.

Bagaimana Cara Mencadangkan dan Memulihkan Coolify dalam 12 Menit Sebelum Server Anda Tumbang pada Jumat Malam

Kita semua pernah mengalaminya. Ini hari Jumat malam, Anda baru saja menyelesaikan pekerjaan, Anda bersiap untuk minum sesuatu dan bersantai, dan kemudian... BOOM! Server Anda mati. Lingkungan produksi Anda tumbang, dan hati Anda mencelos.

Jika Anda menggunakan Coolify, Anda tahu betapa hebatnya alat ini. Namun, jika Anda belum menyiapkan strategi pencadangan, Anda sedang bermain api. Dalam panduan ini, saya akan menunjukkan cara mencadangkan dan memulihkan instansi Coolify Anda hanya dalam 12 menit, sehingga Anda dapat tidur nyenyak pada Jumat malam.

Mengapa Anda perlu mencadangkan Coolify?

Coolify menyimpan segalanya: konfigurasi aplikasi Anda, variabel lingkungan, kredensial database, dan banyak lagi. Jika server Anda mati, Anda akan kehilangan semuanya.

Strategi Pencadangan

Untuk mencadangkan Coolify secara penuh, kita membutuhkan dua hal:

  1. Database (PostgreSQL)
  2. File (Volume dan konfigurasi)

Langkah 1: Mencadangkan Database

Coolify menggunakan PostgreSQL untuk menyimpan datanya. Kita dapat menggunakan pg_dumpall untuk membuat cadangan lengkap dari semua database.

Jalankan perintah ini di server Anda:

docker exec -t coolify docker-compose exec postgres pg_dumpall -U postgres > coolify_db_backup.sql

Perintah ini memberi tahu Docker untuk menjalankan pg_dumpall di dalam kontainer coolify dan menyimpan hasilnya ke dalam file bernama coolify_db_backup.sql di mesin host Anda.

Langkah 2: Mencadangkan File

Coolify menyimpan konfigurasi dan data persistennya di /data/coolify. Kita perlu mengompres direktori ini.

Jalankan perintah ini:

tar -czvf coolify_files_backup.tar.gz /data/coolify

Ini akan membuat arsip terkompresi dari direktori /data/coolify.

Langkah 3: Memindahkan Cadangan ke Tempat yang Aman

Sekarang Anda memiliki dua file: coolify_db_backup.sql dan coolify_files_backup.tar.gz. Pindahkan file tersebut ke penyimpanan jarak jauh seperti S3, Google Drive, atau bahkan ke server lain menggunakan scp.

scp coolify_db_backup.sql coolify_files_backup.tar.gz user@remote-server:/path/to/backup/

Langkah 4: Proses Pemulihan

Bayangkan skenario terburuk telah terjadi. Server Anda hilang. Anda telah menyiapkan server baru. Sekarang, mari kita hidupkan kembali Coolify.

1. Instal Coolify

Pertama, instal Coolify di server baru Anda menggunakan skrip instalasi resmi:

curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash

2. Pulihkan File

Hentikan layanan Coolify terlebih dahulu (jika sedang berjalan):

docker stop coolify

(Catatan: Anda mungkin perlu menghentikan semua kontainer terkait).

Sekarang, ekstrak file cadangan Anda ke direktori /data:

tar -xzvf coolify_files_backup.tar.gz -C /

3. Pulihkan Database

Jalankan kembali kontainer Coolify:

docker start coolify

Tunggu hingga kontainer database siap, lalu jalankan:

cat coolify_db_backup.sql | docker exec -i coolify docker-compose exec -T postgres psql -U postgres

Kesimpulan

Dan selesai! Instansi Coolify Anda kembali berjalan, persis seperti sebelum terjadi kerusakan.

Jangan menunggu sampai Jumat malam untuk menyadari bahwa Anda tidak memiliki cadangan. Siapkan ini hari ini!

Jika Anda merasa panduan ini bermanfaat, silakan berikan ❤️ dan bagikan kepada sesama pengembang!