Blog

Coolify dan Claude Code: Deploy Proyek ke VPS Anda Sendiri

Markdown

Menginstal Coolify, menghubungkan GitHub, men-deploy Next.js, domain dan HTTPS, MCP, persyaratan VPS, serta pemecahan masalah. Harga teknis dalam dolar dan batasan asli.

Baca artikel lengkap

Dokumentasi Ailoot — materi referensi untuk menggunakan layanan ini.

Batasan Platform dan Ketentuan Pembayaran pada 2026

Poin utama

Paket gratis berlaku sampai Anda pertama kali melampaui batas; setelah itu, diperlukan kartu internasional. Heroku menutup paket gratisnya untuk semua orang pada 2022 dan memasuki mode pemeliharaan pada Februari 2026. Dengan Coolify yang di-host sendiri, server menjadi milik Anda; tidak ada penagihan per pengguna dan tidak ada vendor lock-in.

Skenario umum vibe-coder pada 2026: Anda membuat MVP di Cursor atau Claude Code dalam satu malam, memindahkannya ke repositori GitHub, membuka vercel.com → menghubungkan repo → sampai ke layar langganan → memasukkan kartu → mendapat pesan Transaction declined.

Ini bukan bug atau gangguan sementara.

Railway, Render, Heroku — ceritanya sama. Heroku benar-benar menutup paket gratisnya untuk semua orang pada 2022, dan pada Februari 2026 proyek tersebut memasuki mode pemeliharaan — tidak ada fitur baru dan tidak ada kontrak Enterprise baru. Bagi pengguna dengan kartu yang tidak didukung, artinya: “pintunya tertutup; cari jalan memutar melalui perantara yang mengenakan komisi 20%.”

Anda bisa membayar melalui kartu Visa virtual di Kazakhstan atau layanan pembayaran korporat. Namun, itu berarti tambahan 20% dari harga, tambahan 30 menit untuk setiap transaksi, serta risiko akun Anda diblokir ketika pemroses pembayaran mendeteksi ketidakcocokan negara.

Contoh asli mencakup tiga percobaan — di Vercel Pro, Railway, dan Render.

Apa Itu Coolify, dan Bagaimana Cara Kerja Platform yang Di-host Sendiri?

Poin utama

Coolify adalah PaaS sumber terbuka yang dapat di-host sendiri dan merupakan alternatif langsung untuk Heroku, Vercel, dan Netlify. Coolify diinstal dengan satu perintah curl pada VPS apa pun yang menjalankan Ubuntu. Di balik layar, Coolify menggunakan Docker + Traefik untuk reverse proxy dan Let's Encrypt untuk HTTPS. Coolify mendukung integrasi GitHub, webhook untuk deployment otomatis, pencadangan S3, serta lebih dari 280 layanan sekali klik (PostgreSQL, Redis, MinIO). Versi self-hosted gratis selamanya tanpa batas. Coolify memiliki 55,800 bintang di GitHub dan lisensi Apache-2.0.

Coolify adalah proyek sumber terbuka yang dibuat dengan Laravel + Docker, yang mengubah VPS kosong menjadi platform deployment aplikasi. Instal Coolify sekali, lalu lakukan hal lainnya melalui antarmuka web: hubungkan GitHub, pilih repositori, lalu klik Deploy.

Dokumentasi resminya menjelaskan secara singkat dan tepat:

Coolify adalah alternatif sumber terbuka dan dapat di-host sendiri untuk Heroku / Netlify / Vercel, dan sebagainya.

— README GitHub Coolify, https://github.com/coollabsio/coolify

Di balik layar, Coolify terdiri atas empat bagian:

  1. Antarmuka web yang dibangun dengan Laravel 12 + Livewire 3 + Tailwind v4 — dasbor untuk mengelola aplikasi Anda.
  2. Docker + Docker Compose — setiap aplikasi berjalan dalam kontainer yang terisolasi dari aplikasi lainnya.
  3. Reverse proxy (Traefik atau Caddy) — menerima lalu lintas HTTP/HTTPS masuk dan merutekannya ke kontainer.
  4. Integrasi Let's Encrypt — menerbitkan dan memperbarui sertifikat SSL secara otomatis untuk semua domain.

Fitur utama yang membuat Coolify sebanding secara fungsional dengan Vercel:

FiturVercelCoolify
Auto-deploy saat git push✅✅ (melalui webhook GitHub)
HTTPS gratis✅✅ (Let's Encrypt)
Deployment pratinjau PR✅✅ (melalui GitHub App)
UI variabel lingkungan✅✅
Pencadangan basis data❌ (tidak menyediakan basis data sendiri)✅ (ke penyimpanan yang kompatibel dengan S3)
PostgreSQL / Redis / MongoDB$20+/bulan masing-masing✅ Sekali klik, gratis
Tugas terjadwal (cron)❌✅ (sintaks cron)
Penagihan per pengguna$20/pengguna/bulanTidak ada
Vendor lock-inTinggi (Edge Functions, ISR)Nol (Docker Anda)
CDN global✅❌ (hanya VPS Anda)

CDN global adalah satu-satunya hal yang tidak disertakan Coolify secara bawaan. Itulah jawaban jujurnya. Jika proyek Anda memiliki audiens global dan Anda perlu mengurangi latensi bagi pengguna di AS dan Eropa, pasang Cloudflare di depannya; layanan ini gratis untuk konten statis.

Harga: versi self-hosted gratis selamanya tanpa batas jumlah aplikasi, server, atau deployment. Coolify Cloud tersedia dengan harga $5/bulan untuk 2 server + $3 untuk setiap server tambahan — tetapi servernya tetap milik Anda; Coolify Cloud hanya meng-host dasbornya.

Rilis terbaru adalah v4.1.0 dari 18 Mei 2026. Fitur baru mencakup build pack Railpack dalam versi beta, pencatatan audit, perbedaan konfigurasi antar-deployment, dan endpoint MCP bawaan (hanya baca). Sumber: rilis GitHub.

VPS Apa yang Sebaiknya Anda Pilih untuk Coolify pada 2026?

Poin utama

Coolify memerlukan minimal 2 vCPU, RAM 2 GB, SSD 30 GB, dan Ubuntu LTS (20.04, 22.04, atau 24.04). VPS dengan spesifikasi seperti ini dapat menjalankan 3–5 proyek vibe coding sekaligus dengan nyaman.

Persyaratan minimum Coolify berasal langsung dari dokumentasi resmi:

ParameterMinimumDisarankan
CPU2 inti2–4 inti
RAM2 GB4 GB (dengan ruang tambahan untuk build)
Penyimpanan30 GB50–80 GB (untuk image + basis data)
ArsitekturAMD64 atau ARM64 (64-bit)AMD64
OSUbuntu LTS 20.04 / 22.04 / 24.0422.04 LTS
RootWajibMelalui kunci SSH, bukan kata sandi

Minimum — RAM 2 GB — adalah batas bawah yang mutlak. Dengan 1 GB, penginstal akan berjalan sampai Docker, kehabisan memori (OOM), lalu macet. Jangan menghemat RAM.

Sumber harga: Timeweb Cloud, FirstVDS, dan Selectel.

Jika Anda membutuhkan daya lebih besar (basis data 100 GB, beberapa instans Postgres), pilih Aeza Dedicated.

Yang JANGAN dipilih:

  • VPS bersama dengan RAM 512 MB–1 GB — bahkan untuk Coolify pun tidak cukup. Ini untuk situs statis di nginx, bukan untuk PaaS.

Ingin bukan hanya menyiapkan deployment, tetapi juga membangun pengaturan yang membuat Claude dapat diandalkan? Coolify adalah alat eksekusi, tetapi tanpa konteks terstruktur (CLAUDE.md, otak kedua, dan rekayasa konteks), Claude tetap akan berhalusinasi dalam tugas yang panjang. Pengaturan lengkap mencakup ketiganya: klon AI + Otak Kedua + Rekayasa Konteks — kombinasi inilah yang mengubah Claude dari “asisten yang berhalusinasi” menjadi alat yang andal.

Cara Menginstal Coolify dalam 5 Menit

Poin utama

Instalasi cukup dengan satu perintah curl dari dokumentasi. Setelah berjalan, antarmuka web akan muncul di port 8000. Di sana, Anda membuat pengguna admin pertama dan melihat dasbor kosong. Waktu sebenarnya dari instalasi Ubuntu kosong hingga Coolify berjalan adalah 5–7 menit, dengan 3–4 menit di antaranya digunakan oleh apt-get install docker. Skrip mengambil dependensi yang diperlukan dan mengonfigurasi Docker sendiri; Anda hanya perlu menunggu sampai selesai.

Langkah 1. Hubungkan ke VPS melalui SSH.

Setelah membuat VPS melalui penyedia, alamat IP server dan kata sandi root akan muncul dalam email atau di panel kontrol. Hubungkan dari komputer lokal Anda:

ssh root@1.2.3.4

Jika penyedia memberi Anda kunci SSH, bukan kata sandi, hubungkan dengan -i path/to/key. Mulai dari sini, diasumsikan Anda menggunakan instalasi Ubuntu 22.04 atau 24.04 LTS yang baru.

Langkah 2. Jalankan perintah instalasi Coolify.

Satu perintah dari dokumentasi resmi:

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

Skrip tersebut melakukan tiga hal:

  1. Memeriksa sistem (Ubuntu LTS? root? AMD64?)
  2. Menginstal Docker dan Docker Compose jika belum terinstal
  3. Mengunduh image Coolify (coolify/coolify, coolify/realtime, traefik) dan menjalankannya di latar belakang melalui docker-compose

Proses ini memerlukan waktu 3–5 menit. Anda akan melihat log apt-get berjalan, lalu docker pull. Saat muncul pesan Coolify v4.1.0 is now running, lanjutkan ke langkah 3.

Langkah 3. Buka antarmuka web.

Buka ini di peramban Anda:

http://1.2.3.4:8000

Coolify akan menampilkan wizard penyiapan — formulir untuk membuat pengguna pertama. Masukkan email dan kata sandi, lalu simpan. Pengguna ini otomatis menjadi admin; Anda belum memerlukan pengguna lain.

Setelah menyimpan, Anda akan masuk ke dasbor kosong: bilah sisi di kiri dengan Resources / Projects / Servers / Sources / Notifications / Settings, dan prompt di tengah untuk “Add your first resource.”

Langkah 4. Buka port di firewall penyedia (bukan UFW).

Coolify sudah berjalan, tetapi dari luar hanya port 8000 (dasbor) yang dapat diakses. Agar pengguna dapat menjangkau aplikasi Anda, buka port 80 (HTTP) dan 443 (HTTPS):

PortTujuan
22Akses SSH ke server
80Menerima lalu lintas HTTP, diperlukan untuk validasi Let's Encrypt
443Menerima lalu lintas HTTPS pengguna
8000Dasbor Coolify (tutup port ini setelah mengonfigurasi domain khusus untuk dasbor)

Satu jebakan penting dari dokumentasi resmi:

Docker menggunakan aturan iptables berbasis NAT yang dapat melewati firewall Linux tradisional seperti UFW.

— Dokumentasi Coolify (firewall), https://coolify.io/docs/knowledge-base/server/firewall

Artinya, meskipun Anda mengaktifkan UFW dan menutup semua port, Docker tetap akan mengekspos kontainernya melalui iptables. UFW tidak berguna di sini. Solusinya adalah membuka dan menutup port di panel kontrol penyedia, bukan melalui UFW. Di Timeweb / Selectel / Aeza, pengaturan ini ada di bagian “Network → Firewall” pada konsol web.

Langkah 5 (opsional). Kaitkan dasbor ke domain Anda.

Untuk mengunjungi https://coolify.example.com alih-alih http://1.2.3.4:8000, buat catatan DNS A coolify.example.com → 1.2.3.4, buka Settings → Instance Settings → Instance Domain di Coolify, masukkan subdomain Anda, lalu simpan. Coolify akan meminta sertifikat Let's Encrypt dan, satu menit kemudian, memuat ulang dasbor melalui HTTPS.

Setelah itu, Anda dapat menutup port 8000 di firewall — dasbor akan tersedia melalui HTTPS pada port standar 443.

Cara Menghubungkan GitHub: App atau PAT?

Poin utama

Coolify mendukung dua cara untuk menghubungkan GitHub: GitHub App (disarankan) dan Personal Access Token (PAT). Gunakan GitHub App: penyiapan memerlukan waktu 5 menit dengan wizard, pratinjau PR berfungsi, dan izin dapat dibatasi secara terperinci pada tingkat repositori. PAT adalah opsi usang untuk kasus lama; PAT tidak mendukung deployment pratinjau dan berisiko memberikan akses global ke semua repositori Anda. Dokumentasi resmi menyatakan langsung, “bagi 95% pengguna, GitHub App adalah pilihan yang tepat.”

Di Coolify, buka Sources → + Add → GitHub App. Coolify akan menampilkan wizard tiga layar:

  1. Name & description — beri nama sumber (masukkan github-main) dan tambahkan deskripsi jika diinginkan.
  2. Configure on GitHub — tombol yang membawa Anda ke GitHub.com dan otomatis membuka formulir pembuatan GitHub App dengan izin yang benar.
  3. Confirm — setelah kembali dari GitHub, klik “Save.”

Pada langkah kedua, GitHub akan meminta Anda mengonfirmasi izin yang diminta Coolify:

IzinTingkat aksesTujuan
ContentsHanya bacaMengkloning repositori
Pull RequestsBaca-tulisMembuat deployment pratinjau dan mengomentari PR
Email addressesHanya bacaMengidentifikasi commit
MetadataHanya bacaMenampilkan daftar repositori

Ini adalah izin minimum — GitHub App tidak dapat melihat kunci privat Anda, tidak dapat menulis ke main, dan tidak dapat mengakses repositori yang belum Anda hubungkan secara eksplisit.

Dari dokumentasi resmi:

Personal Access Token (PAT) adalah metode lama; saya menyarankan agar tidak menggunakannya. Kekurangannya:

  • PAT memberi akses global ke semua repositori Anda (termasuk yang privat)
  • Pratinjau PR tidak berfungsi — fitur tersebut hanya tersedia melalui GitHub App
  • Masa berlaku token panjang (90 hari, satu tahun, atau tanpa batas) — jika token bocor, akibatnya buruk

Gunakan PAT hanya jika Anda bekerja dengan repositori organisasi yang kebijakan keamanannya melarang GitHub Apps dan tidak ada cara lain.

Setelah menyimpan sumber di Coolify, Anda akan melihat GitHub App di dasbor beserta daftar repositori yang terhubung. Saat membuat aplikasi baru, Anda dapat memilih repositori mana pun dengan sekali klik.

Cara Men-deploy Proyek Next.js dari Claude Code dalam 6 Langkah

Poin utama

Alur lengkap dari penyiapan Claude Code kosong hingga situs aktif: 1) jalankan claude dalam folder kosong, jelaskan proyeknya, lalu Claude membuat kodenya; 2) jalankan git init && git remote add (Claude dapat melakukannya sendiri melalui perintah garis miring); 3) push ke GitHub; 4) di Coolify, pilih “+ New Resource → Application” lalu pilih repositori; 5) tambahkan variabel lingkungan; 6) Deploy. Coolify akan mendeteksi bahwa proyek menggunakan Next.js, memilih build pack Nixpacks, membuat image Docker dalam 3–5 menit, dan menyediakan domain sementara dengan HTTPS yang langsung tersedia.

Langkah 1. Jelaskan proyek kepada Claude Code di folder kosong.

mkdir my-vibe-app
cd my-vibe-app
git init
claude

Dalam sesi:

Build a Next.js 14 app router project:
- a home page with a list of users
- /api/users endpoint returns an array from the database
- Postgres via Prisma
- Tailwind for styles
- .env.example with DATABASE_URL
- README.md with instructions for running the project

Claude akan membuat struktur file, package.json, prisma/schema.prisma, dan .env.example. Minta juga:

Create a Dockerfile for production builds and a .dockerignore.

Ini opsional — Coolify akan melakukan build dengan Nixpacks meskipun tanpa Dockerfile. Namun, Dockerfile memberi Anda kendali atas proses dan mempercepat build proyek yang lebih besar.

Langkah 2. Buat repositori GitHub dan push ke sana.

Anda dapat melakukannya secara manual melalui UI GitHub + git remote add origin ..., tetapi Claude Code juga dapat melakukannya sendiri:

/commit-push-pr Initial Next.js app generated with Claude Code

Atau cukup katakan: “Commit everything and push it to a new repository my-vibe-app under my account.” Claude akan menggunakan CLI gh untuk membuat repositori privat (atau publik) dan melakukan push pertama. Sumber: perintah resmi Claude Code.

Langkah 3. Buat Application di Coolify.

Di dasbor Coolify, klik + New → Application. Formulir akan terbuka:

  1. Source — pilih github-main (GitHub App yang Anda hubungkan pada H2 sebelumnya)
  2. Repository — pilih my-vibe-app dari daftar
  3. Branch — main
  4. Build Pack — Coolify akan mendeteksinya secara otomatis. Jika ada Dockerfile, Coolify akan menggunakan dockerfile. Jika tidak, Coolify akan menggunakan nixpacks. Anda dapat menggantinya secara manual.
  5. Domain — biarkan nilai yang disarankan untuk sementara; nilainya sementara dan nanti akan Anda ganti dengan domain sendiri
  6. Port — 3000 untuk Next.js secara default

Simpan.

Langkah 4. Tambahkan variabel lingkungan.

Di aplikasi yang dibuat, buka tab Environment Variables. Tambahkan variabel satu per satu:

DATABASE_URL=postgresql://user:pass@db-host:5432/mydb
NODE_ENV=production
ANTHROPIC_API_KEY=sk-ant-...

Jika Anda tidak memiliki basis data, buat satu langsung di Coolify: + New → Database → PostgreSQL. Coolify akan menjalankan kontainer Postgres dalam 30 detik dan menyediakan DATABASE_URL internal dengan format postgresql://postgres:pass@postgres-xyz:5432/postgres — masukkan URL itu ke aplikasi Anda.

Semua variabel dienkripsi di basis data Coolify dan tidak ditampilkan dalam log build.

Langkah 5. Klik Deploy.

Di sudut kanan atas terdapat tombol Deploy berwarna biru. Log langsung akan muncul di tab Logs:

[stage: clone]   Cloning '<repository-url-from-github>'
[stage: build]   Detected Next.js, using Nixpacks
[stage: build]   Installing Node 20, npm 10
[stage: build]   npm install (245s)
[stage: build]   npm run build (87s)
[stage: deploy]  Creating container my-vibe-app-xyz
[stage: deploy]  Container started, health check passed
[stage: proxy]   Traefik routing configured
[stage: ssl]     Let's Encrypt cert issued

Build pertama memerlukan waktu 3–5 menit (mengambil image dasar Node dan menginstal dependensi). Build selanjutnya memerlukan waktu 60–90 detik berkat cache lapisan Docker.

Saat status berubah menjadi Running, salin URL aplikasi yang ditampilkan pada field Domains di Coolify dan buka URL yang tepat itu di browser. Gunakan nilai tersebut sebagai <app-url-from-coolify> di bawah; label dalam kurung sudut adalah placeholder, bukan alamat nyata. Halaman beranda Anda akan muncul dengan HTTPS yang langsung tersedia. Coolify menggunakan domain sementara agar Anda dapat langsung membuka situs tanpa mengonfigurasi DNS sendiri.

Langkah 6. Periksa apakah semuanya berfungsi.

Buka URL aplikasi dari langkah sebelumnya dengan menambahkan /api/users, misalnya <app-url-from-coolify>/api/users tanpa menggandakan garis miring. Ini endpoint JSON yang dibuat pada Langkah 1; URL akar aplikasi adalah halaman beranda. Jika muncul kesalahan 500, Anda akan melihat stack trace di tab Logs. Masalah paling umum pada deployment pertama adalah DATABASE_URL mengarah ke basis data yang tidak ada. Perbaiki dengan membuat instans PostgreSQL di Coolify (lihat langkah 4 di atas) dan mengganti DATABASE_URL.

15 menit, dihitung sejak Anda memesan VPS. Dalam contoh asli, alur kerja ini memerlukan waktu 12–18 menit pada server baru.

Cara Mengonfigurasi Domain Khusus dan HTTPS

Poin utama

Domain khusus dihubungkan dalam 3 langkah: buat catatan DNS A yang mengarah ke IP server, masukkan domain Anda di Configuration Coolify sebagai pengganti domain sementara, aktifkan Automatic HTTPS, lalu klik Redeploy. Let's Encrypt akan menerbitkan sertifikat SSL secara otomatis 2–3 menit setelah propagasi DNS (biasanya 5–30 menit). Persyaratan utamanya adalah DNS sudah mengarah ke alamat yang benar saat Anda mengeklik Redeploy; jika belum, validasi Let's Encrypt akan gagal dan Anda harus menunggu 12 menit sebelum percobaan berikutnya.

Langkah 1. Buat catatan DNS A di panel kontrol registrar Anda.

Contoh asli menggunakan domain yang di-host di Reg.ru, Beget, atau Timeweb. Prosesnya sama:

Jenis catatanNamaNilai
Aapp (atau @ untuk domain root)1.2.3.4 (IP server)

Simpan, buka konsol, lalu periksa:

dig app.example.com +short
# Seharusnya mengembalikan 1.2.3.4

Jika tidak mengembalikan apa pun atau IP yang berbeda, DNS belum selesai dipropagasikan. Tunggu 5–30 menit.

Langkah 2. Masukkan domain Anda di Coolify.

Di aplikasi, buka tab Configuration → General. Di kolom Domains, ganti URL aplikasi sementara yang disalin dari Coolify dengan https://app.example.com (gunakan domain sendiri yang telah dikonfigurasi). Aktifkan Automatic HTTPS (biasanya sudah aktif secara default).

Simpan lalu klik Redeploy.

Langkah 3. Tunggu sertifikat Let's Encrypt.

Log build akan menampilkan:

[stage: ssl]  Requesting Let's Encrypt cert for app.example.com
[stage: ssl]  HTTP challenge sent to /.well-known/acme-challenge/xxx
[stage: ssl]  Validation passed, cert issued
[stage: ssl]  Cert installed, HTTPS enabled

Dalam 2–3 menit, situs Anda akan tersedia di https://app.example.com dengan ikon gembok hijau di bilah alamat.

Masalah yang dapat terjadi dengan Let's Encrypt (3 masalah teratas dari panduan pemecahan masalah resmi):

  1. Port 80 tertutup di firewall. Let's Encrypt memvalidasi dengan tantangan HTTP — layanan ini mengirim permintaan ke http://app.example.com/.well-known/acme-challenge/xxx. Validasi tidak akan berhasil tanpa port 80. Buka port tersebut di firewall penyedia.
  2. Proxy Cloudflare aktif (awan oranye). Proxy mencegat permintaan Let's Encrypt dan mengembalikan halaman placeholder miliknya sendiri — validasi gagal. Solusinya adalah beralih ke “DNS only” (awan abu-abu) atau mengonfigurasi tantangan DNS-01 melalui Cloudflare API.
  3. DNS belum selesai dipropagasikan. Jika Anda membuat catatan A 30 detik lalu dan langsung mengeklik Redeploy, Let's Encrypt belum dapat melihat domain Anda. Tunggu 5–30 menit agar DNS terpropagasi di server-server.

Batas laju Let's Encrypt: 5 percobaan gagal per jam untuk satu domain, dengan pemulihan sebanyak 1 percobaan setiap 12 menit. Jika mencapai batas, jangan mengeklik Redeploy 10 kali berturut-turut; periksa log, perbaiki masalahnya, lalu coba lagi dalam 12 menit.

Bagaimana Claude Code Mengelola Coolify melalui MCP?

Poin utama

Melalui Model Context Protocol, Claude Code mendapat akses langsung ke Coolify API — Anda dapat mengatakan “deploy this application” untuk memulai build, memeriksa status, membaca log, atau memperbarui variabel lingkungan. Ada tiga opsi: forsonny/Coolify-MCP-Server (dasar, 7 kategori operasi), dazeb/coolify-mcp-enhanced (15+ alat tambahan dengan deployment basis data sekali klik), dan ajmcclary/Coolify-Manager (Claude Skill yang dibuat berdasarkan CLI resmi). Mulai v4.1.0 (18 Mei 2026), Coolify menyediakan endpoint MCP bawaan tanpa server pihak ketiga — tetapi untuk saat ini hanya mendukung baca.

Model Context Protocol (MCP) adalah standar dari Anthropic yang memungkinkan Claude Code berkomunikasi dengan sistem eksternal (lihat panduan server MCP untuk informasi selengkapnya). Hubungkan server MCP dan Claude akan mendapat sekumpulan alat yang dapat dipanggilnya. Ada tiga server siap pakai untuk Coolify, ditambah satu opsi bawaan.

Opsi 1. forsonny/Coolify-MCP-Server-for-Claude-Code — dasar.

Kemampuannya:

  • Applications: membuat, memulai, menghentikan, memulai ulang
  • Services: menampilkan daftar, membuat, memulai/menghentikan/memulai ulang
  • Deployments: melihat yang sedang berjalan, mengambil berdasarkan UUID
  • Teams & Members: menampilkan daftar, mendapatkan info
  • SSH Keys: menampilkan daftar, membuat
  • Environment Variables: CRUD lengkap untuk aplikasi dan layanan
  • Server Insights: domain per server, kesehatan, versi

Instalasi:

git clone '<OFFICIAL_URL>'
cd Coolify-MCP-Server-for-Claude-Code
npm install
npm run build
# In .env:
#   COOLIFY_BASE_URL=https://coolify.example.com
#   COOLIFY_API_TOKEN=[from Coolify Settings → API Tokens]
npm run setup  # automatically configures Claude Code

Setelah itu, Anda dapat menulis ini di Claude Code:

Show the status of the my-vibe-app application in Coolify and the 3 latest deployments.

Claude akan menampilkan tabel.

Opsi 2. dazeb/coolify-mcp-enhanced — lebih lengkap (disarankan).

Tambahan dari kumpulan fitur dasar:

  • Deployment PostgreSQL / Redis / MinIO sekali klik melalui AI — minta “set up Postgres for me,” lalu AI membuat kontainer dan mengembalikan DATABASE_URL
  • Pemantauan waktu nyata + penggunaan sumber daya — CPU/RAM untuk setiap aplikasi secara waktu nyata
  • Pembaruan konfigurasi env massal — perbarui 20 variabel dengan satu perintah
  • Dukungan Docker Compose — deploy aplikasi multi-layanan

Konfigurasi untuk Claude Code (.mcp.json di root proyek):

{
  "mcpServers": {
    "coolify-enhanced": {
      "command": "node",
      "args": ["/path/to/coolify-mcp-enhanced/dist/index.js"],
      "env": {
        "COOLIFY_ACCESS_TOKEN": "your-token-here",
        "COOLIFY_BASE_URL": "https://coolify.example.com"
      }
    }
  }
}

Opsi 3. ajmcclary/Coolify-Manager — Claude Skill yang dibuat berdasarkan CLI.

Ini bukan server MCP, melainkan Claude Code Skill yang membungkus CLI resmi Coolify. Isinya mencakup:

  • Diagnostik kesehatan untuk layanan dan kontainer
  • Diagnostik sertifikat SSL
  • Dukungan beberapa instans (jika Anda memiliki beberapa server Coolify)
  • Panduan pemecahan masalah

Instalasi: unduh skill dan letakkan di ~/.claude/skills/coolify-manager/. Claude Code akan menemukannya dan menawarkannya untuk tugas yang relevan.

Opsi 4 (baru pada Mei 2026). MCP bawaan di Coolify v4.1.0.

Catatan perubahan v4.1.0 bertanggal 18 Mei 2026 menyatakan:

Menambahkan dukungan MCP tingkat instans dengan alat hanya baca untuk sumber daya dan API/UI Coolify.

Coolify kini menyediakan endpoint MCP sendiri — Anda dapat menghubungkan Claude Code secara langsung tanpa server pihak ketiga. Untuk saat ini, fitur ini hanya mendukung baca (daftar aplikasi, status, konfigurasi), tanpa operasi perubahan. Namun, ini sudah cukup untuk kebanyakan tugas seperti “beri tahu saya tentang infrastrukturnya.”

Hubungkan melalui .mcp.json:

{
  "mcpServers": {
    "coolify-native": {
      "url": "https://coolify.example.com/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-token>"
      }
    }
  }
}

Tunggu hingga akses tulis penuh tersedia di MCP bawaan pada v4.2 atau v4.3 — tim Coolify menjanjikannya sebelum akhir 2026.

5 Jebakan pada Deployment Pertama — dan Cara Menghindarinya

Poin utama

Kesalahan yang paling umum pada deployment pertama adalah RAM yang tidak cukup, port 80 tertutup, proxy Cloudflare yang merusak Let's Encrypt, UFW yang gagal melindungi Docker, dan memilih PAT alih-alih GitHub App. Semua masalah ini dibahas dalam dokumentasi resmi, tetapi mudah terjadi jika belum berpengalaman langsung. Berikut daftar periksa 5 poin berdasarkan pengalaman awal menginstal Coolify.

Jebakan 1: RAM kurang dari 2 GB — instalasi gagal dengan OOM.

Gejala: curl install.sh mencapai docker pull coolify/coolify, macet di 70%, lalu proses dihentikan dengan Killed (signal 9). Log dmesg | tail menampilkan Out of memory: Killed process.

Solusi:

# Buat file swap 4 GB untuk mengatasi masalah sementara
sudo fallocate -l 4G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

Untuk jangka panjang, tingkatkan RAM menjadi 4 GB. Coolify dapat berjalan dengan swap, tetapi build proyek Next.js yang besar mungkin gagal.

Jebakan 2: UFW aktif, tetapi Docker tetap membuka port.

Gejala: Anda mengaktifkan UFW dan menutup semua port kecuali 22, tetapi aplikasi tetap dapat diakses dari internet melalui port acak (seperti 3000).

Alasannya, menurut dokumentasi resmi:

Coolify berjalan di Docker, yang menggunakan aturan iptables berbasis NAT dan dapat melewati firewall Linux tradisional seperti UFW.

— Dokumentasi Coolify (firewall), https://coolify.io/docs/knowledge-base/server/firewall

Solusi: gunakan firewall di panel kontrol penyedia, bukan UFW. Timeweb / Selectel / Aeza memiliki bagian “Firewall” atau “Network → Firewall” untuk mengonfigurasi aturan pada tingkat jaringan virtual — aturan ini bekerja sebelum paket mencapai Docker.

Alternatifnya adalah ufw-docker, skrip yang menambal UFW agar kompatibel dengan Docker. Namun, ini lebih rumit daripada mengeklik pengaturan di panel kontrol.

Jebakan 3: Proxy Cloudflare (awan oranye) merusak Let's Encrypt.

Gejala: setelah Redeploy, log menampilkan Let's Encrypt validation failed - challenge returned 403.

Alasan: Cloudflare mem-proxy permintaan HTTP Let's Encrypt dan mengembalikan halamannya sendiri alih-alih berkas challenge Anda.

Solusi — pilih salah satu dari dua opsi:

  1. Beralih ke “DNS only” (awan abu-abu di Cloudflare). Kekurangannya: Anda kehilangan CDN dan perlindungan Cloudflare.
  2. Konfigurasikan tantangan DNS-01 melalui Cloudflare API. Di Coolify, buka Settings → SSL Configuration, pilih penyedia Cloudflare, lalu masukkan token API dengan izin Zone:Read dan DNS:Edit. Let's Encrypt akan memvalidasi melalui catatan TXT, bukan HTTP.

Opsi kedua lebih rumit untuk disiapkan, tetapi mempertahankan proxy Cloudflare.

Jebakan 4: PAT alih-alih GitHub App — pratinjau PR tidak berfungsi.

Gejala: Anda menghubungkan GitHub melalui Personal Access Token; semuanya berfungsi, tetapi deployment pratinjau tidak dibuat untuk PR. Anda membuka PR di GitHub, tetapi tidak ada yang muncul di Coolify.

Alasan: pratinjau PR adalah fitur eksklusif GitHub App. PAT tidak menerima peristiwa pull_request melalui webhook.

Solusi: hubungkan ulang GitHub melalui App. Sources → Add → GitHub App → selesaikan wizard. Anda dapat menghapus sumber PAT lama.

Jebakan 5: “Coolify == Vercel” tidak sepenuhnya benar.

Hal-hal yang tidak dilakukan Coolify secara bawaan:

VercelCoolifyYang harus dilakukan
CDN globalTidakPasang Cloudflare di depannya (gratis untuk konten statis)
Incremental Static RegenerationTidakrevalidatePath hanya berfungsi di server Anda
Optimasi gambarTidakGunakan next/image dengan loader lokal atau Cloudflare Images
Penskalaan otomatis saat lonjakanTidakSkalakan secara manual; tingkatkan VPS Anda
Edge FunctionsTidakGunakan rute API biasa

Jika proyek Anda adalah SaaS dengan lalu lintas tinggi, audiens global, dan persyaratan latensi < 100 ms di seluruh dunia, Coolify tidak cocok; pilih Vercel Enterprise. Jika Anda seorang vibe-coder dengan MVP yang sedang diuji pada 100–1,000 pengguna per hari, Coolify menyediakan semua yang dibutuhkan.

Dari analisis self-hosting yang jujur:

Angka 15 menit pada judul panduan ini merujuk pada jalur paling lancar untuk deployment pertama satu proyek. Penyiapan infrastruktur lengkap dengan pemantauan, pencadangan, dan peringatan memerlukan satu atau dua malam. Bersikaplah jujur kepada diri sendiri.

Berapa Banyak yang Akan Anda Hemat dalam Setahun Dibandingkan dengan Vercel?

Poin utama

Ada “pajak waktu tersembunyi” sebesar 5–10 jam untuk penyiapan awal dan 1–2 jam per bulan untuk pemeliharaan.

Angka Vercel di bawah adalah perkiraan skenario artikel pada Mei 2026, bukan penawaran harga saat ini. Itu hanya satu sisi perbandingan. Coolify self-hosted tidak memiliki biaya lisensi, tetapi VPS, cadangan, penyimpanan, trafik, dan operasi tetap berbiaya. Dapatkan penawaran yang memenuhi persyaratan di atas; skenario ini tidak menyertakan harga VPS numerik, sehingga klaim penghematan tetap tidak didukung.

Misalkan C adalah total tagihan infrastruktur bulanan untuk VPS terpilih, penyimpanan cadangan, trafik tambahan, pemantauan, dan opsi dasbor berbayar. Hitung setiap pengeluaran sekali. Misalkan r adalah biaya per jam pekerjaan operasi Anda, dengan mata uang yang sama sepanjang perhitungan. Estimasi waktu artikel adalah 5–10 jam awal ditambah 1–2 jam per bulan: 17–34 jam pada tahun pertama dan 12–24 jam pada tahun berikutnya.

SkenarioPerkiraan Vercel/bulanVercel/tahunInfrastruktur Coolify/bulanTCO Coolify tahun pertama, termasuk tenaga kerjaPenghematan tahun pertama terhadap Vercel
Satu prototipe, 100,000 kunjungan/bulan$20 dasar + ~$5 bandwidth = $25$300C12C + (17–34)r$300 − 12C − (17–34)r
Lima proyek pada satu VPS$20 dasar + $30 bandwidth/fungsi = $50$600C12C + (17–34)r$600 − 12C − (17–34)r
Tiga pengembang, lima proyek$60 kursi + $30 bandwidth = $90$1,080C12C + (17–34)r$1,080 − 12C − (17–34)r

Gunakan C terpisah pada tiap skenario jika beban kerja membutuhkan ukuran server berbeda. Untuk perbandingan bulanan, bagi waktu pengaturan awal selama 12 bulan: ekuivalen bulanan tahun pertama adalah C + (17–34)r/12. TCO tahun berikutnya adalah 12C + (12–24)r. Rumus ini membandingkan perkiraan Vercel yang dinyatakan dengan biaya self-hosting; sertakan biaya operasi sebanding pada sisi Vercel juga. Penghematan negatif berarti self-hosting lebih mahal dengan masukan Anda. Jangan menghitung gaji penuh insinyur yang sama lagi jika r sudah mencakupnya.

Sebelum beralih, isi C berdasarkan penawaran penyedia nyata dan rencana cadangan, tentukan r, lalu bandingkan pemakaian aktual selama sebulan. Tanpa masukan itu, artikel mendukung model biaya, bukan klaim penghematan dolar.

Manfaat utamanya bukan uang. Saat beralih ke Coolify, kategori “bergantung pada kebijakan pembayaran pihak lain” tidak lagi berlaku. Kartu virtual perantara dengan komisi 20% tidak lagi diperlukan.

Coolify bukan Vercel yang lebih murah. Coolify adalah kategori produk yang berbeda: Anda memiliki infrastrukturnya, bertanggung jawab atasnya, dan menghemat uang dengan menerima kompleksitasnya.

Jika men-deploy prototipe adalah tugas pertama Anda setelah membuat proyek di Claude Code, pengelolaan lingkungan (env, rahasia, tugas terjadwal, pencadangan) merupakan bagian dari rekayasa konteks. Tanpa struktur untuk “di mana semuanya berada,” Claude akan kebingungan, dan Anda akan kehilangan waktu setiap kali ada perubahan. Pengaturan lengkap mencakup: klon AI (Skills dan Subagents yang disesuaikan dengan metodologi Anda) + Otak Kedua (basis pengetahuan proyek) + Rekayasa Konteks (Plan Mode, /compact, lingkungan eksekusi). Inilah 3 pilar yang tanpanya AI berhalusinasi.

Alur kerja konteks lengkap: Klon AI + Otak Kedua + Rekayasa Konteks.

Materi lainnya tersedia di Ailoot.

Rincian selengkapnya

Pertanyaan tentang Coolify dan Claude Code: Deploy Proyek ke VPS Anda Sendiri

URL mana yang harus mengembalikan JSON setelah deployment?

Salin URL aplikasi pada field Domains di Coolify dan buka jalur /api/users-nya. URL akar adalah halaman beranda; /api/users adalah endpoint JSON yang ditetapkan dalam proyek contoh.

Bagaimana menghitung apakah self-hosting menghemat uang?

Jumlahkan biaya VPS bulanan, cadangan, penyimpanan, trafik, pemantauan, dan dasbor opsional ke C. TCO self-hosting tahun pertama adalah 12C ditambah 17–34 jam pada biaya per jam Anda; bandingkan dengan estimasi tahunan Vercel pada skenario dan sertakan biaya operasi sebanding pada kedua sisi.

Semua artikel