Coolify: Panduan Lengkap Instalasi untuk Pengelolaan Server dan Aplikasi Sendiri

Posted on June 13, 2024

Ingin mengelola aplikasi dan server web Anda sendiri tanpa ribet? Coolify hadir sebagai solusi inovatif! Artikel ini akan membahas panduan lengkap instalasi Coolify versi self-hosted di server Anda.

Persiapan Server

Langkah pertama adalah menyiapkan server. Anda dapat menggunakan VPS (Virtual Private Server), Raspberry Pi, atau server lain yang memiliki akses SSH.

Penyedia Server Pilihan:

Kami merekomendasikan Hetzner sebagai penyedia server terpercaya. Anda bisa menggunakan referral link kami untuk membantu pengembangan Coolify [link referral Hetzner].

Catatan Penting tentang Instalasi:

Perintah instalasi singkat:

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

Persyaratan Sistem:

  • Sistem Operasi yang Didukung:
    • Distribusi Linux berbasis Debian (Debian, Ubuntu, dll.)
    • Distribusi Linux berbasis Redhat (CentOS, Fedora, Redhat, AlmaLinux, Rocky dll.)
    • Distribusi Linux berbasis SUSE (SLES, SUSE, openSUSE, dll.)
    • Arch Linux
    • Raspberry Pi OS (Raspbian)
  • Arsitektur yang Didukung:
    • AMD64
    • ARM64
  • Spesifikasi Server Minimum:
    • Coolify:
      • 2 CPU
      • Memori 2 GB
      • Storage 30+ GB (untuk image)
    • Resource Anda:
      • Penggunaan resource server tergantung kebutuhan Anda. Jika berencana menjalankan banyak aplikasi, pilih server dengan resource lebih besar.
      • Hosting Supabase, Appwrite, atau Posthog membutuhkan resource lebih banyak dibandingkan hosting static site.

Sebagai Contoh:

Server produksi kami memiliki spesifikasi sebagai berikut:

  • Memori 8 GB (rata-rata penggunaan 3.5 GB)
  • CPU 4 (rata-rata penggunaan ~20-30%)
  • Disk 150 GB (penggunaan 40 GB)

Aplikasi yang Dihosting:

  • 3 Aplikasi NodeJS
  • 4 Static Site
  • Plausible Analytics (analitik pengunjung)
  • Fider (tool feedback)
  • UptimeKuma (monitoring uptime)
  • Ghost (newsletter)
  • 3 Database Redis
  • 2 Database PostgreSQL

Metode Instalasi

  • Otomatis (Docker Engine)

Penggunaan metode ini memerlukan Docker Engine (bukan Docker Desktop). Petunjuk khusus untuk Docker Desktop akan dijelaskan kemudian.

Prasyarat:

SSH Aktif:
Pastikan SSH aktif dan Anda dapat terhubung ke server menggunakan SSH dari komputer lokal dengan akses root.

Perintah curl Tersedia:
Yakinlah perintah curl tersedia di server Anda.

Eksekusi Perintah Instalasi:
Jalankan perintah berikut pada server dengan akses root:

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

Anda dapat melihat kode sumber script ini [link ke kode sumber script instalasi].

Akses UI Coolify:
Setelah instalasi selesai, Anda dapat mengakses Coolify melalui port http://:8000.

Penjelasan Script Instalasi:

  • Script akan melakukan langkah-langkah berikut pada sistem operasi Anda:
    • Menginstal perintah dasar: curl, wget, git, jq, jc
    • Menginstal Docker Engine (versi 24 ke atas)
    • Mengkonfigurasi logging yang tepat untuk Docker Engine
    • Membuat struktur direktori di /data/coolify untuk semua file konfigurasi
    • Membuat SSH key untuk Coolify agar dapat mengelola server dari dirinya sendiri (tersimpan di /data/coolify/ssh/keys/id.root@host.docker.internal)
    • Menginstal dan menjalankan Coolify dalam container Docker.
  • Manual

Catatan: Metode ini direkomendasikan untuk pengguna yang lebih berpengalaman.

Prasyarat

SSH Aktif:
Pastikan SSH aktif dan Anda dapat terhubung ke server menggunakan SSH dari komputer lokal dengan akses root.

Perintah curl Tersedia:
Yakinlah perintah curl tersedia di server Anda.

Instal Docker Engine (versi 24 ke atas):
Ikuti dokumentasi resmi untuk instalasi Docker Engine di server Anda: [link dokumentasi instalasi Docker Engine].

Buat Direktori: 

mkdir -p /data/coolify/{source,ssh
mkdir -p /data/coolify/{applications,databases,backups,services,proxy,webhooks-during-maintenance}
mkdir -p /data/coolify/ssh/{keys,mux}
mkdir -p /data/coolify/proxy/dynamic

Membuat SSH Key:

ssh-keygen -f /data/coolify/ssh/keys/id.root@host.docker.internal -t ed25519 -N '' -C root@coolify

Pengaturan SSH Key: Tambahkan public SSH key Anda ke ~/.ssh/authorized_keys. Hal ini memungkinkan Coolify untuk terhubung ke server dari dirinya sendiri.

cat /data/coolify/ssh/keys/id.root@host.docker.internal.pub >>~/.ssh/authorized_keys

chmod 600 ~/.ssh/authorized_keys

Anda dapat melewati langkah ini jika sudah memiliki SSH key. Tapi, Anda perlu menambahkan key ini ke instance Coolify setelah instalasi.

Pastikan Anda menyimpan nilai-nilainya di tempat aman. Kehilangan nilai-nilai ini akan mengakibatkan hilangnya akses ke instalasi Coolify dan semua data Anda.

Pengaturan File Konfigurasi

Salin file docker-compose.yml, docker-compose.prod.yml, .env.production, dan upgrade.sh dari CDN Coolify ke /data/coolify/source.

curl -fsSL https://cdn.coollabs.io/coolify/docker-compose.yml -o /data/coolify/source/docker-compose.yml

curl -fsSL https://cdn.coollabs.io/coolify/docker-compose.prod.yml -o /data/coolify/source/docker-compose.prod.yml

curl -fsSL https://cdn.coollabs.io/coolify/.env.production -o /data/coolify/source/.env

curl -fsSL https://cdn.coollabs.io/coolify/upgrade.sh -o /data/coolify/source/upgrade.sh

Pengaturan Perizinan:

Atur izin untuk semua file dan direktori.

chown -R 9999:root /data/coolify

chmod -R 700 /data/coolify

Membuat Nilai Variable:

Buat nilai untuk variable berikut di /data/coolify/source/.env.

sed -i "s|APP_ID=.*|APP_ID=$(openssl rand -hex 16)|g" /data/coolify/source/.env

sed -i "s|APP_KEY=.*|APP_KEY=base64:$(openssl rand -base64 32)|g" /data/coolify/source/.env

sed -i "s|DB_PASSWORD=.*|DB_PASSWORD=$(openssl rand -base64 32)|g" /data/coolify/source/.env

sed -i "s|REDIS_PASSWORD=.*|REDIS_PASSWORD=$(openssl rand -base64 32)|g" /data/coolify/source/.env

sed -i "s|PUSHER_APP_ID=.*|PUSHER_APP_ID=$(openssl rand -hex 32)|g" /data/coolify/source/.env

sed -i "s|PUSHER_APP_KEY=.*|PUSHER_APP_KEY=$(openssl rand -hex 32)|g" /data/coolify/source/.env

sed -i "s|PUSHER_APP_SECRET=.*|PUSHER_APP_SECRET=$(openssl rand -hex 32)|g" /data/coolify/source/.env

Jaringan Docker Default: Pastikan jaringan Docker Coolify default tersedia. “`bash
docker network create –attachable coo

Langkah ini hanya perlu dilakukan sekali saat instalasi Coolify pertama kali. Jika dilakukan setelah Coolify dijalankan, instalasi Anda akan rusak.

Pastikan Anda menyimpan nilai-nilainya di tempat aman. Kehilangan nilai-nilai ini akan mengakibatkan hilangnya akses ke instalasi Coolify dan semua data Anda.

Panduan Lengkap Instalasi Coolify (Lanjutan)

Membuat Jaringan Docker Default (Lanjutan):

docker network create --attachable coolify

Memulai Coolify:

Jalankan perintah berikut untuk memulai Coolify:

docker compose --env-file /data/coolify/source/.env -f /data/coolify/source/docker-compose.yml -f /data/coolify/source/docker-compose.prod.yml up -d --pull always --remove-orphans --force-recreate

Mengakses UI Coolify:

Setelah proses instalasi selesai, Anda dapat mengakses UI Coolify melalui port http://:8000.

Instalasi dengan Docker Desktop (Tidak Direkomendasikan untuk Produksi)

Metode ini hanya direkomendasikan untuk tujuan pengujian dan tidak disarankan untuk penggunaan produktif.

Langkah-langkah:

  1. Instal Docker Desktop untuk Windows:
    Ikuti petunjuk resmi untuk menginstal Docker Desktop di Windows: [link dokumentasi instalasi Docker Desktop Windows].
  2. Membuat Direktori:
    Buat direktori untuk menyimpan data terkait Coolify. Contohnya, di direktori User: C:\Users\yourusername\coolify.
  3. Menyalin File Konfigurasi:
    Salin file docker-compose.windows.yml dan .env.windows-docker-desktop.example ke direktori yang dibuat pada langkah 2.
  4. Mengubah Nama File Konfigurasi:
    Ubah nama docker-compose.windows.yml menjadi docker-compose.yml.
    Ubah nama .env.windows-docker-desktop.example menjadi .env.
  5. Membuat Jaringan Docker Coolify:
    Jalankan perintah berikut untuk membuat jaringan Docker Coolify: docker network create coolify
  6. Mengubah Nilai Variable (Opsional):
    Anda dapat mengubah nilai variable di file .env sesuai kebutuhan.
  7. Memulai Coolify:
    Jalankan perintah berikut untuk memulai Coolify: docker compose up
  8. Mengakses UI Coolify:
    Anda dapat mengakses UI Coolify melalui port localhost:8000 di komputer Anda.

Catatan:

  • Coolify Proxy tidak berfungsi dengan baik di Windows.

Tips:

  • Pastikan Anda selalu memperbarui Coolify ke versi terbaru untuk mendapatkan fitur dan keamanan terbaik.
  • Gunakan password yang kuat untuk melindungi instalasi Coolify Anda.
  • Bacalah dokumentasi resmi Coolify dengan seksama sebelum memulai instalasi.
  • Jika Anda mengalami masalah saat instalasi, jangan ragu untuk bertanya di forum komunitas Coolify.

Kesimpulan:

Coolify menawarkan solusi inovatif untuk mengelola aplikasi dan server web Anda sendiri dengan mudah dan hemat. Dengan panduan lengkap ini, Anda dapat memulai perjalanan Anda dalam self-hosting dan menikmati kontrol penuh atas aplikasi dan data Anda.

Semoga bermanfaat!