Coolify로 셀프 호스팅 PaaS 구축하기 – 월 5달러로 Heroku 대체

Coolify를 선택해야 하는 이유

상용 PaaS의 비용 부담과 한계

솔직히 말씀드리면, 저도 처음엔 Heroku를 정말 편하게 썼습니다. Git push 한 번이면 배포가 끝나니까요. 그런데 2022년 무료 플랜이 종료되고, 간단한 사이드 프로젝트 하나에 월 7달러씩 내다 보니 프로젝트가 3개만 넘어가도 부담스러워지더라고요. Vercel이나 Netlify도 좋지만, 정적 사이트나 서버리스에 특화되어 있어서 데이터베이스가 필요한 풀스택 앱은 결국 별도 서비스를 또 결합해야 했습니다.

2026년 현재, 1인 개발자나 소규모 팀이 여러 프로젝트를 운영하려면 PaaS 비용만 월 수십에서 수백 달러가 훌쩍 넘어갑니다. 취미 프로젝트나 MVP 테스트용으로는 너무 부담스러운 금액이죠.

Coolify의 핵심 장점과 특징

Coolify로 셀프 호스팅 PaaS 구축하기를 시도한 건 비용 때문이었지만, 써보니 그 이상의 가치가 있었습니다. 가장 큰 장점은 **완전한 통제권**입니다. 내 서버에서 돌아가니 벤더 락인 걱정이 없고, 원하는 대로 커스터마이징할 수 있습니다.

특히 인상 깊었던 건 280개 이상의 원클릭 서비스 지원이었습니다. PostgreSQL, MySQL, Redis는 기본이고, Plausible Analytics, Umami, n8n 같은 도구들을 클릭 몇 번으로 배포할 수 있더라고요. 각 서비스마다 Docker Compose 파일 작성하고 설정 파일 만지작거리던 시간이 아까울 정도였습니다.

어떤 프로젝트/팀에게 적합한가

Coolify로 셀프 호스팅 PaaS 구축하기가 적합한 경우는 명확합니다. 여러 개의 사이드 프로젝트를 운영하는 1인 개발자, 스타트업 초기 단계에서 인프라 비용을 최소화하고 싶은 팀, 그리고 데이터 주권이 중요한 프로젝트에 딱입니다.

반대로 서버 관리에 전혀 손대고 싶지 않거나, 트래픽이 급증할 때 자동 스케일링이 필수적인 서비스라면 관리형 PaaS가 더 나을 수 있습니다. 하지만 솔직히 대부분의 사이드 프로젝트는 오토 스케일링이 필요한 수준까지 가지 않더라고요.

Coolify 설치 및 초기 설정

서버 준비하기 (AWS Lightsail/Ubuntu 기준)

저는 AWS Lightsail의 월 $5 플랜(1GB RAM, 1 vCPU, 40GB SSD)으로 시작했습니다. Ubuntu 22.04 LTS를 선택했고요. 처음엔 “1GB 메모리로 충분할까?” 걱정했는데, 소규모 프로젝트 2~3개 돌리는 데는 문제없었습니다. 물론 데이터베이스까지 함께 돌리면 조금 빠듯하긴 합니다.

Lightsail 대신 DigitalOcean, Hetzner, 또는 Vultr도 좋은 선택입니다. 특히 Hetzner는 가성비가 뛰어나서 유럽 지역 서비스라면 강력 추천합니다. 중요한 건 Ubuntu 22.04 이상이면 된다는 점입니다.

원라인 설치 명령어로 환경 구축

서버에 SSH로 접속한 후 Coolify 설치는 정말 간단했습니다:

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

이 명령어 하나면 Docker, Docker Compose, 필요한 의존성이 모두 자동 설치됩니다. 제 경험상 5분 정도 걸렸고, 중간에 아무것도 건드릴 필요가 없었습니다. 설치가 완료되면 서버 IP의 8000번 포트로 Coolify 웹 인터페이스에 접속할 수 있습니다.

처음 시도했을 때 한 가지 실수가 있었는데, 방화벽에서 8000번 포트를 열어놓지 않아서 접속이 안 됐습니다. Lightsail을 쓴다면 네트워킹 탭에서 8000번 포트를 꼭 열어주세요.

초기 접속 및 관리자 계정 설정

http://your-server-ip:8000 으로 접속하면 초기 설정 화면이 나옵니다. 관리자 이메일과 비밀번호를 설정하는데, 이때 강력한 비밀번호를 사용하는 게 중요합니다. 저는 1Password로 생성한 랜덤 비밀번호를 썼습니다.

초기 설정 시 Coolify는 자체 업데이트 채널을 선택하게 하는데, stable 채널을 추천합니다. beta나 nightly는 최신 기능을 빨리 써볼 수 있지만, 프로덕션 환경에서는 안정성이 우선이니까요.

보안 설정 (포트 관리 및 방화벽)

Coolify로 셀프 호스팅 PaaS 구축하기에서 가장 중요한 부분이 보안입니다. 초기 설정 후 반드시 해야 할 작업들이 있습니다:

• 도메인 연결: 8000번 포트로 직접 접속하는 대신, admin.yourdomain.com 같은 서브도메인을 연결하세요. Coolify 설정에서 간단히 추가할 수 있습니다.
• SSL 인증서: 도메인 연결 후 Let’s Encrypt 자동 발급 기능을 활성화하면 됩니다. 클릭 한 번이면 HTTPS가 적용됩니다.
• 8000번 포트 차단: 도메인 설정이 완료되면 방화벽에서 8000번 포트를 외부 접근 차단으로 바꾸세요. Coolify는 내부적으로 리버스 프록시를 통해 작동하니 문제없습니다.
• SSH 키 기반 인증: 서버 SSH 접속을 비밀번호 대신 키 기반으로 바꾸는 것도 필수입니다.

처음엔 이 과정이 번거롭게 느껴질 수 있지만, 한 번만 설정하면 됩니다. 보안 사고가 나면 복구하는 게 훨씬 더 고통스럽다는 걸 경험으로 배웠습니다.

첫 애플리케이션 배포하기

GitHub App 연동 설정

Coolify의 진가는 GitHub 연동부터 드러납니다. Settings > Source 메뉴에서 GitHub App을 생성할 수 있는데, OAuth App이 아니라 GitHub App 방식이라 권한 관리가 더 세밀합니다.

GitHub App 생성 과정에서 Webhook URL을 설정하는데, 여기서 주의할 점이 있습니다. 서버 IP 직접 입력이 아니라 도메인을 사용해야 합니다. 저는 처음에 IP로 설정했다가 나중에 IP가 바뀌면서 Webhook이 작동 안 해서 한참 헤맸습니다.

프로젝트 생성 및 저장소 연결

Projects 메뉴에서 새 프로젝트를 생성하고, 배포할 GitHub 저장소를 선택합니다. Coolify는 Dockerfile이 있으면 자동으로 감지하고, 없으면 Nixpacks나 Buildpacks를 사용해서 빌드합니다.

제가 배포한 첫 프로젝트는 Next.js 앱이었는데, 별도 설정 없이 자동으로 감지되어서 놀랐습니다. Node.js 버전만 환경변수로 지정해주면 됐습니다.

환경 변수 및 빌드 설정

환경변수 설정은 Coolify 웹 인터페이스에서 간편하게 할 수 있습니다. .env 파일을 직접 업로드할 수도 있고, 키-값 쌍으로 하나씩 추가할 수도 있습니다. 민감한 정보는 당연히 Git에 올리지 말고 여기서 관리해야겠죠.

빌드 설정에서 실수했던 부분이 있는데, Next.js 프로젝트에서 standalone 모드를 활성화하지 않아서 이미지 크기가 불필요하게 컸습니다. next.config.js에 output: ‘standalone’을 추가하니 배포 속도가 훨씬 빨라졌습니다.

도메인 연결 및 SSL 인증서 자동 발급

Coolify로 셀프 호스팅 PaaS 구축하기의 가장 만족스러운 부분 중 하나가 도메인 설정입니다. 프로젝트 설정에서 도메인을 입력하면, Let’s Encrypt를 통해 자동으로 SSL 인증서를 발급받고 갱신까지 해줍니다.

DNS 설정은 A 레코드로 서버 IP를 가리키기만 하면 됩니다. Cloudflare를 쓴다면 프록시 모드를 켜도 되고, DNS만 쓰려면 회색 구름으로 바꾸면 됩니다. 저는 Cloudflare 프록시를 켜서 DDoS 보호와 CDN 효과를 함께 얻고 있습니다.

자동 배포 (Webhook) 설정하기

GitHub 저장소에 push하면 자동으로 배포되게 하려면 Webhook 설정이 필요한데, GitHub App 연동이 되어 있으면 자동으로 설정됩니다. main 브랜치에 커밋이 푸시되면 몇 초 내로 Coolify가 감지하고 빌드를 시작합니다.

한 가지 팁은, 브랜치별로 다른 환경을 만들 수 있다는 점입니다. main은 프로덕션, develop은 스테이징으로 나눠서 각각 다른 도메인과 환경변수를 설정할 수 있습니다. Heroku의 Pipeline 기능과 비슷한데, 추가 비용이 없다는 게 큰 장점이죠.

데이터베이스 및 서비스 관리

원클릭 데이터베이스 배포 (PostgreSQL, MySQL, Redis 등)

Databases 메뉴에서 PostgreSQL을 클릭 몇 번으로 배포했을 때, 솔직히 너무 간단해서 의심스러웠습니다. “이게 맞나?” 싶을 정도로요. 버전 선택하고, 비밀번호 설정하고, 배포 버튼 누르면 끝입니다.

데이터베이스는 자동으로 Docker 볼륨에 저장되고, Coolify 내부 네트워크에서만 접근 가능하게 설정됩니다. 외부에서 접근하려면 포트를 명시적으로 열어야 하는데, 보안상 권장하지 않습니다. 대신 Coolify 내부에서 배포한 앱끼리는 서비스 이름으로 바로 연결됩니다.

280+ 지원 서비스 활용하기

Coolify로 셀프 호스팅 PaaS 구축하기를 하면서 가장 즐거웠던 부분은 원클릭 서비스 카탈로그였습니다. 분석 도구, 모니터링, CMS, 자동화 도구까지 280개가 넘는 오픈소스 서비스를 클릭 몇 번으로 배포할 수 있습니다.

제가 실제로 배포해서 쓰고 있는 서비스들:

• Plausible Analytics: Google Analytics 대신 프라이버시 친화적인 분석 도구
• Uptime Kuma: 서비스 모니터링 및 알림
• n8n: Zapier 대체 자동화 워크플로우
• Ghost: 블로그 플랫폼 (WordPress보다 가볍습니다)
• MinIO: S3 호환 오브젝트 스토리지

각 서비스마다 Docker Compose 파일을 찾고, 볼륨 마운트 설정하고, 리버스 프록시 구성하던 걸 생각하면… Coolify가 엄청난 시간 절약을 해줬습니다.

백업 및 복구 전략

셀프 호스팅의 가장 큰 책임은 백업입니다. Coolify는 자동 백업 기능을 제공하는데, S3 호환 스토리지로 정기적으로 백업할 수 있습니다. 저는 Backblaze B2를 사용하는데, 10GB까지 무료이고 그 이상도 저렴합니다.

백업 설정에서 실수했던 점은, 처음엔 데이터베이스만 백업하고 볼륨은 제외했다는 겁니다. 나중에 업로드된 파일들이 사라질 뻔했죠. 볼륨 백업도 꼭 함께 설정하세요.

리소스 모니터링

Coolify 대시보드에서 CPU, 메모리, 디스크 사용량을 실시간으로 볼 수 있습니다. 그런데 솔직히 내장 모니터링은 기본적인 수준이라, 저는 앞서 말한 Uptime Kuma를 추가로 배포해서 더 상세한 모니터링을 하고 있습니다.

리소스가 부족할 때는 Lightsail 플랜을 업그레이드하거나, 서버를 여러 개로 나누는 방법이 있습니다. Coolify는 멀티 서버 관리도 지원해서, 하나의 Coolify 인스턴스에서 여러 서버에 배포할 수 있습니다.

실전 운영 팁과 트러블슈팅

멀티 프로젝트 관리 전략

Coolify로 셀프 호스팅 PaaS 구축하기의 장점은 프로젝트가 늘어날수록 빛을 발합니다. 저는 현재 하나의 서버에서 5개 프로젝트를 운영 중인데, 각각 독립적인 도메인과 환경을 가지면서도 비용은 서버 비용 하나뿐입니다.

프로젝트별로 팀과 권한을 나눌 수 있어서, 클라이언트 프로젝트를 관리할 때도 유용합니다. 각 클라이언트에게 자신의 프로젝트만 볼 수 있는 계정을 만들어주면 됩니다.

비용 최적화 방법

셀프 호스팅의 가장 큰 이유가 비용 절감인데, 몇 가지 최적화 팁이 있습니다:

• 이미지 크기 줄이기: Multi-stage Docker 빌드를 사용하면 최종 이미지 크기를 크게 줄일 수 있습니다. 배포 속도도 빨라지고 디스크 공간도 절약됩니다.
• 미사용 이미지 정리: Coolify는 자동으로 오래된 이미지를 정리하지만, 설정에서 보관 개수를 조정할 수 있습니다.
• 리소스 제한 설정: 각 서비스별로 메모리와 CPU 제한을 걸어두면, 한 서비스가 전체 서버를 장악하는 걸 막을 수 있습니다.
• CDN 활용: 정적 파일은 Cloudflare 같은 무료 CDN을 앞에 두면 서버 부하를 줄일 수 있습니다.

자주 발생하는 문제와 해결법

Coolify를 운영하면서 겪은 문제들과 해결 방법을 공유합니다:

빌드가 중간에 멈춤: 메모리 부족이 원인인 경우가 많습니다. 서버에 스왑 메모리를 추가하거나, 빌드 중 메모리를 많이 쓰는 프로세스(npm install 등)를 최적화하세요.

Webhook이 작동 안 함: GitHub에서 Webhook 전달 기록을 확인해보세요. 방화벽이나 Cloudflare 설정 때문에 차단되는 경우가 있습니다.

데이터베이스 연결 실패: Coolify 내부 네트워크에서는 서비스 이름으로 연결해야 합니다. localhost나 127.0.0.1이 아니라 데이터베이스 서비스 이름을 호스트로 사용하세요.

디스크 공간 부족: Docker 이미지와 로그가 쌓이면 디스크가 금방 찹니다. docker system prune -a 명령어로 정리하거나, Coolify 설정에서 자동 정리를 활성화하세요.

업데이트 및 유지보수

Coolify는 웹 인터페이스에서 원클릭으로 업데이트할 수 있습니다. 새 버전이 나오면 알림이 뜨고, 버튼 하나면 업데이트가 진행됩니다. 다만 중요한 업데이트 전에는 백업을 꼭 하는 습관을 들이세요.

2026년 현재 Coolify는 매우 활발하게 개발되고 있어서, 거의 매주 새로운 기능이 추가됩니다. 업데이트 전에 릴리스 노트를 확인하는 게 좋고, 특히 breaking changes가 있는지 체크하세요.

자주 묻는 질문 (FAQ)

Q. Vercel/Heroku 대비 장단점은?

장점: 비용이 압도적으로 저렴하고, 완전한 통제권을 가질 수 있으며, 벤더 락인이 없습니다. 데이터베이스와 280개 이상의 서비스를 추가 비용 없이 사용할 수 있습니다.

단점: 서버 관리의 책임이 있고, 자동 스케일링이 없으며, 초기 설정에 시간이 필요합니다. 글로벌 CDN이나 엣지 기능은 Vercel보다 부족합니다. 하지만 대부분의 사이드 프로젝트에는 이런 기능이 필수가 아니더라고요.

Q. 예상 비용은 얼마나 드나요?

Coolify로 셀프 호스팅 PaaS 구축하기의 비용은 서버 비용이 전부입니다. AWS Lightsail 기준으로 월 $5부터 시작할 수 있고, 프로젝트가 늘어나면 $10~20 정도로 업그레이드하면 됩니다. 저는 5개 프로젝트를 $10 플랜에서 운영 중입니다. Heroku로 같은 구성을 하면 월 $35 이상이었을 겁니다.

백업 스토리지 비용이 추가로 들지만, Backblaze B2는 10GB까지 무료고 그 이상도 저렴합니다. 결론적으로 월 $10~15면 여러 프로젝트를 충분히 운영할 수 있습니다.

Q. 팀 협업은 어떻게 하나요?

Coolify는 팀 멤버를 초대하고 프로젝트별 권한을 설정할 수 있습니다. 각 멤버는 자신의 계정으로 로그인해서 배포 기록 확인, 로그 조회, 환경변수 수정 등을 할 수 있습니다. GitHub 연동이 되어 있어서 코드 푸시만으로 배포되니, 팀원들은 Coolify에 직접 접속할 일이 거의 없습니다.

Q. 프로덕션 환경에서 안정적인가요?

솔직하게 말씀드리면, Coolify는 아직 Heroku나 Vercel만큼의 안정성 트랙 레코드는 없습니다. 하지만 2026년 현재 버전 4.x는 상당히 성숙했고, 많은 기업들이 프로덕션에서 사용하고 있습니다. 저도 6개월간 운영하면서 큰 문제를 겪은 적은 없습니다.

다만 고가용성이 필수적인 서비스라면 서버를 여러 개로 구성하거나, 중요한 서비스는 관리형 PaaS와 병행하는 것도 방법입니다. 모든 걸 Coolify에 올릴 필요는 없으니까요.

Q. 학습 곡선이 얼마나 되나요?

Docker를 전혀 몰라도 Coolify 사용은 가능합니다. 하지만 문제가 생겼을 때 해결하려면 기본적인 Linux 명령어와 Docker 개념은 알아야 합니다. 저는 서버 관리 경험이 거의 없는 상태에서 시작했는데, 한두 주 정도 문서 읽고 실험하니 충분히 익숙해졌습니다. ChatGPT나 Claude 같은 AI 도구의 도움을 받으면 학습 속도가 훨씬 빠릅니다.

결론: 나만의 PaaS로 개발 생산성 높이기

Coolify로 셀프 호스팅 PaaS 구축하기는 제 개발 워크플로우를 완전히 바꿔놓았습니다. 프로젝트를 시작할 때마다 “이걸 어디에 배포하지?”라는 고민이 사라졌고, 인프라 비용 걱정 없이 아이디어를 바로 테스트할 수 있게 됐습니다.

물론 완벽한 솔루션은 아닙니다. 초기 설정에 시간이 들고, 서버 관리라는 책임이 따르며, Vercel의 엣지 기능 같은 최신 기술은 없습니다. 하지만 여러 사이드 프로젝트를 운영하는 1인 개발자에게는 이보다 나은 선택지를 찾기 어렵습니다.

가장 큰 가치는 자유로움입니다. 어떤 기술 스택이든, 어떤 프레임워크든, 어떤 데이터베이스든 제약 없이 사용할 수 있습니다. 벤더의 정책 변경이나 가격 인상을 걱정할 필요도 없습니다. 내 서버, 내 데이터, 내 통제권입니다.

만약 여러분이 Heroku 대안을 찾고 있거나, PaaS 비용 부담을 느끼고 있거나, 단순히 새로운 기술을 배우고 싶다면 Coolify를 시도해보세요. 월 $5짜리 서버 하나면 시작할 수 있고, 마음에 안 들면 언제든 되돌릴 수 있습니다. 저는 6개월 전에 시작했고, 지금은 되돌아갈 생각이 없습니다.

Coolify로 셀프 호스팅 PaaS 구축하기, 여러분도 충분히 할 수 있습니다. 완벽하게 이해하고 시작할 필요는 없습니다. 저도 시행착오를 겪으며 배웠으니까요. 중요한 건 첫 걸음을 떼는 것입니다. 행운을 빕니다!