Cách Cài Coolify Trên Ubuntu 22.04/24.04 – Cài Coolify Trên VPS & Cloud Server

Cách cài Coolify trên Ubuntu chỉ mất 5 phút với một dòng lệnh duy nhất — nhưng nếu chưa chuẩn bị đúng VPS, bạn sẽ mắc ngay lỗi port conflict hoặc Docker không tương thích. Bài viết này hướng dẫn đầy đủ cả Quick Install lẫn Manual Install, kèm cảnh báo lỗi thực tế từ cộng đồng, giúp bạn self-host ứng dụng thay Heroku và Vercel trên VPS riêng. Cùng InterData đi từng bước.

Coolify là gì? Vì sao developer Việt chuyển sang self-host?

Coolify là nền tảng PaaS (Platform as a Service) mã nguồn mở, cho phép bạn deploy ứng dụng web, database và dịch vụ trên VPS riêng thông qua giao diện web — không cần gõ lệnh mỗi lần triển khai. Coolify chạy trên Docker, dùng Traefik làm reverse proxy và tự động cấp SSL qua Let’s Encrypt. Người sáng lập là Andras Bacsai (coollabsio).

Heroku đã bỏ free tier từ 2022. Vercel và Railway tính phí theo usage, dễ phát sinh bill bất ngờ khi app có traffic tăng đột biến. Với Coolify trên VPS, bạn trả một mức phí cố định hàng tháng cho server và deploy không giới hạn số app. Chi phí có thể chỉ bằng 1/3 đến 1/5 so với dùng PaaS trả phí, đặc biệt khi chạy 3–5 ứng dụng trở lên.

Coolify v4 (phiên bản stable hiện tại) hỗ trợ:

• Deploy từ GitHub, GitLab, Bitbucket hoặc Git repository bất kỳ
• One-click service: PostgreSQL, Redis, MongoDB, MySQL, MinIO, Plausible Analytics, Uptime Kuma, Ghost, n8n và hơn 100 dịch vụ khác
• Preview deployment cho mỗi pull request
• SSL tự động qua Let’s Encrypt
• Quản lý multi-server từ một dashboard
• Backup database lên S3-compatible storage
• Hỗ trợ Nixpacks, Dockerfile và Docker Compose

Yêu cầu hệ thống trước khi cài Coolify trên Ubuntu

Trước khi bắt đầu, bạn cần một VPS chạy Ubuntu Server với quyền root hoặc sudo. Dưới đây là bảng cấu hình chi tiết theo tài liệu chính thức của Coolify:

Thông số	Tối thiểu	Khuyến nghị (3–5 app)
CPU	2 vCPU	4 vCPU
RAM	2 GB	4–8 GB
Ổ cứng	30 GB SSD	80–100 GB NVMe
Hệ điều hành	Ubuntu 22.04 LTS hoặc Ubuntu 24.04 LTS (khuyến nghị 24.04)
Docker	Docker Engine 24+ (script cài tự cài Docker nếu chưa có)
Port cần mở	22 (SSH), 80 (HTTP), 443 (HTTPS), 8000 (Coolify dashboard)
Quyền truy cập	root hoặc user có sudo, SSH enabled

Lưu ý quan trọng: Ubuntu non-LTS (ví dụ 23.10, 24.10) không được Quick Install hỗ trợ — phải dùng Manual Install. Nếu VPS chỉ có 2 GB RAM, bạn vẫn cài được Coolify nhưng khi build app nặng (Next.js, Laravel) sẽ thiếu RAM. Nên bật swap 2–4 GB hoặc chọn VPS 4 GB RAM trở lên.

Checklist chuẩn bị VPS trước khi cài Coolify

• VPS chạy Ubuntu 22.04 LTS hoặc 24.04 LTS, có quyền root
• SSH hoạt động bình thường (kết nối được từ terminal/PuTTY)
• Port 80 và 443 chưa bị chiếm bởi Nginx hoặc Apache
• Docker chưa cài hoặc cài bằng Docker Engine chính thức (không phải Docker Snap)
• Firewall (ufw) đã mở port 22, 80, 443, 8000
• Domain đã trỏ DNS về IP của VPS (nếu muốn dùng domain ngay)

Cách cài Coolify trên Ubuntu bằng Quick Install (1 lệnh)

Đây là cách nhanh nhất để cài Coolify trên Ubuntu LTS. Script chính thức sẽ tự động cài Docker Engine (nếu chưa có), cấu hình Docker daemon, tạo SSH key, tải Docker Compose files và khởi động Coolify. Toàn bộ quá trình mất khoảng 2–5 phút tùy tốc độ mạng.

Bước 1: SSH vào VPS

Mở terminal (hoặc PuTTY trên Windows) và kết nối SSH với quyền root:

ssh root@IP_VPS_CUA_BAN

Thay IP_VPS_CUA_BAN bằng địa chỉ IP thật của VPS. Nếu dùng user thường, hãy đảm bảo user đó có quyền sudo.

Bước 2: Cập nhật hệ thống

apt update && apt upgrade -y

Bước này đảm bảo các package hệ thống (curl, wget, openssl) ở phiên bản mới nhất, tránh lỗi tương thích khi script Coolify chạy.

Bước 3: Chạy script cài đặt Coolify

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

Script sẽ tự động thực hiện:

1. Kiểm tra và cài các dependency: curl, wget, git, jq, openssl
2. Cài Docker Engine 24+ (nếu chưa có) và cấu hình Docker daemon
3. Tạo SSH key cho Coolify tại /data/coolify/ssh/
4. Tải Docker Compose configuration files
5. Tạo Docker network coolify
6. Khởi động Coolify bằng Docker Compose

Chờ cho đến khi terminal hiển thị thông báo cài đặt thành công. Không tắt terminal giữa chừng.

Bước 4: Truy cập Coolify Dashboard

Mở trình duyệt và truy cập:

http://IP_VPS_CUA_BAN:8000

Tạo tài khoản admin ngay lập tức. Đây là bước bắt buộc. Nếu không tạo ngay, bất kỳ ai biết IP VPS của bạn đều có thể truy cập port 8000 và tự tạo tài khoản admin — chiếm quyền quản trị toàn bộ server. Sau khi tạo admin xong, trang đăng ký sẽ tự động đóng.

Bước 5: Cấu hình ban đầu

Sau khi đăng nhập dashboard, Coolify sẽ hỏi bạn vài thông tin cơ bản:

Chọn loại máy chủ: Chọn nơi triển khai các ứng dụng và cơ sở dữ liệu của bạn. Bạn có thể chọn “This Machine” để bắt đầu nhanh trên VPS hiện tại.

Cách cài Coolify thủ công trên Ubuntu (Manual Install)

Manual Install phù hợp khi bạn dùng Ubuntu non-LTS, muốn kiểm soát từng bước, hoặc VPS đã có Docker Engine cài sẵn. Dưới đây là quy trình theo tài liệu chính thức tại coolify.io/docs.

Bước 1: Cài Docker Engine

Nếu VPS chưa có Docker, cài bằng script chính thức của Docker (không dùng apt install docker.io và tuyệt đối không dùng Docker Snap):

curl -fsSL https://get.docker.com | sh

Kiểm tra Docker đã chạy:

docker version

Bước 2: Tạo thư mục cần thiết

mkdir -p /data/coolify/{source,ssh,applications,databases,backups,services,proxy,webhooks-during-maintenance,metrics,logs}

Bước 3: Tạo SSH key cho Coolify

ssh-keygen -f /data/coolify/ssh/[email protected] -t ed25519 -N '' -C root@coolify

Thêm public key vào authorized_keys để Coolify tự SSH vào server:

cat /data/coolify/ssh/[email protected] >> ~/.ssh/authorized_keys
chmod 600 ~/.ssh/authorized_keys

Bước 4: Tải file cấu hình Docker Compose

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

Bước 5: Set permission và tạo Docker network

chown -R 9999:root /data/coolify
chmod -R 700 /data/coolify

docker network create --attachable coolify 2>/dev/null

Bước 6: Khởi động Coolify

cd /data/coolify/source
docker compose up -d --pull always --remove-orphans --force-recreate

Chờ khoảng 1–2 phút để tất cả container khởi động. Kiểm tra trạng thái:

docker compose ps

Khi thấy các container coolify, coolify-db, coolify-realtime ở trạng thái “Up” — truy cập http://IP_VPS:8000 và tạo tài khoản admin ngay.

Lỗi thường gặp khi cài Coolify trên Ubuntu và cách xử lý

Dưới đây là 5 lỗi mà hầu hết người cài Coolify lần đầu đều gặp. Nếu bạn chuẩn bị trước, sẽ tiết kiệm hàng giờ debug.

Lỗi 1: Port 80/443 bị chiếm bởi Nginx hoặc Apache

Coolify dùng Traefik làm reverse proxy, cần chiếm port 80 và 443. Nếu VPS đã cài đặt Nginx hoặc Apache đang chạy, Traefik không khởi động được. Kiểm tra:

sudo lsof -i :80
sudo lsof -i :443

Nếu thấy nginx hoặc apache2, bạn có hai lựa chọn:

• Cách 1 (khuyến nghị): Gỡ bỏ Nginx/Apache nếu không cần dùng cho mục đích khác: sudo systemctl stop nginx && sudo systemctl disable nginx
• Cách 2: Giữ Nginx làm reverse proxy phía trước, cấu hình Coolify dùng port khác cho Traefik — nhưng cách này phức tạp hơn và phải tự cấu hình SSL.

Lỗi 2: Docker cài qua Snap không tương thích

Ubuntu Server mặc định có thể cài Docker qua Snap — nhưng Docker Snap không tương thích với Coolify. Kiểm tra:

which docker
snap list | grep docker

Nếu Docker cài qua Snap, gỡ bỏ và cài lại bằng Docker Engine chính thức:

sudo snap remove docker
curl -fsSL https://get.docker.com | sh

Lỗi 3: Không tạo tài khoản admin ngay — bị chiếm quyền server

Sau khi cài xong, port 8000 mở cho bất kỳ ai truy cập. Nếu bạn để qua đêm mà chưa tạo admin, bot scan hoặc người lạ có thể truy cập và tạo tài khoản admin trước bạn. Hậu quả: họ kiểm soát toàn bộ Coolify dashboard, có thể deploy code bất kỳ lên server.

Giải pháp: Tạo admin ngay trong 1–2 phút sau khi cài xong. Nếu không thể tạo ngay, dùng firewall chặn port 8000 từ bên ngoài cho đến khi sẵn sàng:

sudo ufw deny 8000

Mở lại khi cần truy cập: sudo ufw allow 8000

Lỗi 4: VPS 2 GB RAM — build app bị kill do thiếu bộ nhớ

Coolify chạy được trên 2 GB RAM, nhưng khi build app Node.js hoặc Laravel, quá trình build tiêu tốn 1–3 GB RAM. Hệ thống sẽ kill process vì OOM (Out of Memory). Bật swap để giảm rủi ro:

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

Swap không thay thế được RAM thật — build sẽ chậm hơn đáng kể so với VPS 4–8 GB RAM. Nếu bạn chạy 3+ app và có database, nên dùng VPS 4 GB RAM trở lên.

Lỗi 5: Không cập nhật Coolify — dính lỗ hổng bảo mật

Năm 2026, Coolify đã được phát hiện và vá nhiều lỗ hổng nghiêm trọng (CVE-2026-34592 Authentication Bypass, CVE-2026-34034 Command Injection, CVE-2026-27957 RCE). Nếu chạy phiên bản cũ mà không cập nhật, server của bạn có thể bị khai thác từ xa.

Coolify có tính năng auto-update trong dashboard (Settings → Auto Update). Bật lên và kiểm tra phiên bản định kỳ.

So sánh Coolify với Heroku, Dokku và CapRover

Nếu bạn đang phân vân giữa các PaaS, bảng dưới đây so sánh 4 lựa chọn phổ biến nhất theo tiêu chí mà developer Việt quan tâm:

Tiêu chí	Coolify	Heroku	Dokku
Loại	Self-hosted, mã nguồn mở	Managed PaaS, trả phí	Self-hosted, mã nguồn mở
Giao diện	Web UI đầy đủ	Web UI + CLI	CLI thuần (không có web UI)
Chi phí	Miễn phí (trả tiền VPS)	$5–25+/dyno/tháng	Miễn phí (trả tiền VPS)
SSL tự động	Có (Let’s Encrypt qua Traefik)	Có (ACM)	Có (plugin letsencrypt)
Database one-click	PostgreSQL, Redis, MongoDB, MySQL, MariaDB	Add-on trả phí	Plugin (cần cài thêm)
Multi-server	Có (quản lý từ 1 dashboard)	Không (dùng Pipeline)	Không
Preview Deployment	Có (theo PR)	Có (Review Apps)	Không
Phù hợp với	Dev muốn web UI, self-host nhiều app	Dev không muốn quản lý server	Dev thích CLI, chạy 1–2 app nhỏ

Kết luận ngắn: Coolify là lựa chọn tốt nhất nếu bạn muốn giao diện web, chạy nhiều app + database trên cùng server, và không muốn phụ thuộc vào PaaS trả phí. Dokku phù hợp nếu bạn quen CLI và chỉ cần deploy 1–2 app đơn giản. Heroku vẫn có giá trị nếu bạn không muốn quản lý server — nhưng chi phí sẽ tăng nhanh khi scale.

Deploy ứng dụng đầu tiên trên Coolify sau khi cài đặt

Cài xong Coolify chỉ mới là bước đầu. Phần này hướng dẫn bạn deploy một ứng dụng thật — từ kết nối GitHub đến cấu hình domain và bật SSL.

Kết nối GitHub với Coolify

1. Trong Coolify dashboard, vào Sources → Add → chọn GitHub App
2. Coolify sẽ hướng dẫn bạn tạo một GitHub App trên tài khoản GitHub của bạn. Làm theo hướng dẫn trên màn hình, cấp quyền truy cập repo.
3. Sau khi authorize xong, bạn sẽ thấy danh sách repo trong Coolify.

Coolify cũng hỗ trợ GitLab, Bitbucket và bất kỳ Git repository public nào. Nếu dùng GitLab self-hosted, bạn có thể kết nối qua Deploy Key.

Tạo project và deploy app

1. Vào Projects → Add New Project → đặt tên (ví dụ “My Blog”)
2. Trong project, chọn Add New Resource → Public Repository hoặc Private Repository (GitHub App)
3. Nhập URL repo hoặc chọn từ danh sách repo đã kết nối
4. Coolify tự phát hiện loại app (Node.js, PHP, Python, static site) qua Nixpacks. Bạn cũng có thể chọn build bằng Dockerfile hoặc Docker Compose nếu repo đã có sẵn.
5. Nhấn Deploy — theo dõi build log realtime trên dashboard

Cấu hình domain và SSL tự động

Sau khi app deploy thành công:

1. Vào phần Settings của resource → mục Domains
2. Nhập domain bạn muốn gắn (ví dụ app.yourdomain.com). DNS của domain phải trỏ A record về IP VPS.
3. Traefik sẽ tự động xin chứng chỉ SSL từ Let’s Encrypt — không cần cấu hình gì thêm. HTTPS hoạt động trong 1–2 phút.

Nếu cần database (PostgreSQL, Redis, MySQL), vào Projects → Add New Resource → Database → chọn loại → Coolify tạo container database với credentials tự sinh. Bạn copy connection string để gắn vào environment variable của app.

Chọn VPS hay Cloud Server để chạy Coolify?

Câu trả lời phụ thuộc vào số lượng app bạn chạy và tần suất thay đổi tải.

Tiêu chí	VPS	Cloud Server
Quy mô	1–5 app, 1–2 database	5–15+ app, multi-database, multi-server
Scale tài nguyên	Nâng gói cố định	Tăng/giảm RAM, CPU theo nhu cầu, không đổi máy
Chi phí	Cố định, dễ dự toán	Linh hoạt hơn khi tải biến động
Phù hợp	Freelancer, startup nhỏ, dự án cá nhân	Agency, team dev, doanh nghiệp cần scale nhanh

Khuyến nghị thực tế: Bắt đầu với VPS 4 GB RAM nếu bạn mới dùng Coolify lần đầu và chạy dưới 5 app. Khi cần quản lý nhiều app hơn, thêm database nặng, hoặc dùng tính năng multi-server của Coolify để phân tải — chuyển sang Cloud Server để nâng/hạ tài nguyên nhanh mà không cần migrate dữ liệu sang máy mới.

Để tham khảo, Andras Bacsai — người sáng lập Coolify — chia sẻ setup thực tế của mình: server 8 GB RAM, 4 CPU, 150 GB storage, chạy đồng thời 3 ứng dụng Node.js, 4 static sites, Plausible Analytics, Uptime Kuma, Ghost, 3 Redis và 2 PostgreSQL.

Câu hỏi thường gặp về cách cài Coolify trên Ubuntu

Coolify có miễn phí không?

Coolify hoàn toàn miễn phí khi tự host trên VPS của bạn — mã nguồn mở theo giấy phép Apache 2.0. Chi phí duy nhất là tiền thuê VPS hoặc Cloud Server. Coolify cũng có bản Cloud hosted trả phí nếu bạn không muốn tự quản lý server, nhưng bài viết này hướng dẫn cách self-host.

Cài Coolify trên Ubuntu 22.04 hay 24.04 LTS tốt hơn?

Cả hai đều được Coolify hỗ trợ chính thức qua Quick Install. Ubuntu 24.04 LTS được khuyến nghị vì có hỗ trợ dài hạn đến 2029, kernel và package mới hơn. Ubuntu 22.04 vẫn chạy tốt nếu VPS đang dùng sẵn — không cần cài lại OS chỉ để nâng lên 24.04.

VPS bao nhiêu RAM thì đủ chạy Coolify?

Tối thiểu 2 GB RAM để Coolify hoạt động, nhưng thực tế cần 4 GB trở lên nếu bạn build app Node.js, Laravel hoặc chạy kèm database. Với 2 GB, bạn nên bật swap 2–4 GB và chỉ chạy 1–2 app nhẹ (static site, API nhỏ).

Coolify dùng Traefik hay Nginx làm reverse proxy?

Mặc định Coolify dùng Traefik — tự động xử lý routing, SSL và load balancing cho tất cả app được deploy. Bạn không cần cài Nginx riêng. Nếu VPS đang chạy Nginx cho mục đích khác, cần tắt Nginx trước khi cài Coolify hoặc cấu hình Nginx proxy pass đến Traefik — nhưng cách này phức tạp và không khuyến nghị cho người mới.

Coolify có hỗ trợ deploy Laravel, Next.js, Django không?

Có. Coolify dùng Nixpacks để tự phát hiện ngôn ngữ và framework, sau đó build Docker image tự động. Laravel (PHP), Next.js (Node.js), Django (Python), Rails (Ruby), Go, Rust đều được hỗ trợ. Nếu app có Dockerfile riêng, Coolify sẽ ưu tiên dùng Dockerfile đó thay vì Nixpacks.

Nội dung mang tính tham khảo tại thời điểm tháng 8/2026. Các bước cài đặt, cấu hình và tính năng Coolify có thể thay đổi theo phiên bản Coolify, Docker Engine, hệ điều hành Ubuntu và môi trường thực tế của từng VPS. Nên kiểm thử trên staging, sao lưu dữ liệu trước khi thao tác trên production, và tham khảo tài liệu chính thức tại coolify.io/docs để cập nhật thông tin mới nhất.