홈

© 2025 Ki Chang. All rights reserved.

본 블로그의 콘텐츠는 CC BY-NC-SA 4.0 라이선스를 따릅니다.

개인정보처리방침이용약관

© 2025 Ki Chang. All rights reserved.

콘텐츠: CC BY-NC-SA 4.0

개인정보처리방침|이용약관

Coolify 설치 가이드: 우분투 서버에 나만의 PaaS 환경 구축하기

정기창·2025년 12월 16일

Coolify 설치 방법에 대해 자세히 알아보겠습니다. Coolify는 Docker 기반 앱 배포를 자동화하여 개발 및 운영 효율성을 극대화하는 데 도움을 줍니다.

1. Coolify란 무엇인가요?

Coolify는 오픈소스 셀프 호스팅 PaaS (Platform as a Service) 솔루션입니다. Heroku나 Netlify와 같은 상용 PaaS의 기능을 나만의 서버에서 직접 구축할 수 있게 해주죠. Docker 컨테이너 기술을 기반으로 하여, 웹 애플리케이션, 데이터베이스, 백그라운드 서비스 등 다양한 애플리케이션을 쉽고 빠르게 배포하고 관리할 수 있습니다.

  • 오픈소스: 자유롭게 사용하고 기여할 수 있습니다.

  • 셀프 호스팅: 데이터를 직접 통제하고 비용을 절감할 수 있습니다.

  • Docker 기반: 일관된 환경에서 애플리케이션을 배포하고 실행합니다.

  • 배포 자동화: CI/CD 파이프라인 구축을 간소화하여 개발 생산성을 높입니다.

2. 우분투 서버에 Coolify 설치하기

우분투 서버에 Coolify를 설치하는 과정은 다음과 같습니다. 원활한 설치를 위해 아래 단계를 순서대로 진행해주세요.

2.1 시스템 업데이트 및 업그레이드

가장 먼저, 시스템의 패키지 목록을 최신화하고 기존 패키지들을 업그레이드합니다. 이는 잠재적인 오류를 방지하고 최신 버전의 소프트웨어를 사용하는 데 중요합니다.

sudo apt update && sudo apt upgrade -y

2.2 Coolify 설치 스크립트 실행

Coolify는 공식 설치 스크립트를 제공하여 매우 쉽게 설치할 수 있습니다. 아래 명령어를 터미널에 입력하여 설치를 시작합니다.

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

이 스크립트는 Coolify와 필요한 모든 종속성을 자동으로 설치합니다. 설치가 완료될 때까지 잠시 기다려주세요.

2.3 방화벽(UFW) 설정

보안 강화를 위해 우분투의 기본 방화벽인 UFW (Uncomplicated Firewall)를 설정해야 합니다. Coolify 대시보드와 배포된 앱에 접근하기 위해 필요한 포트를 열어줍니다.

sudo ufw allow 22/tcp   # SSH 접속 포트
sudo ufw allow 80/tcp   # HTTP (웹 서비스) 포트
sudo ufw allow 443/tcp  # HTTPS (SSL 웹 서비스) 포트
sudo ufw allow 8000/tcp # Coolify 대시보드 기본 포트
sudo ufw enable         # UFW 활성화

sudo ufw status 명령으로 현재 방화벽 규칙을 확인할 수 있습니다.

2.4 불필요한 서비스 비활성화 (선택 사항)

웹 서비스와 직접적인 관련이 없으면서 시스템 자원(특히 메모리)을 사용하는 기본 서비스들을 비활성화하여 서버 리소스를 최적화할 수 있습니다. 이는 특히 리소스가 제한적인 클라우드 VPS 환경에서 유용합니다.

  • snapd: 스냅 패키지 관리자 (일반적인 웹서버 환경에서는 불필요하며 약 100MB의 메모리를 절약할 수 있습니다.)

  • multipathd: SAN 스토리지용 다중 경로 데몬 (클라우드 VPS에서는 대부분 불필요합니다.)

sudo systemctl disable --now snapd snapd.seeded
sudo systemctl disable --now multipathd

이 작업을 통해 서버의 불필요한 부하를 줄이고 Coolify 및 앱 구동에 더 많은 자원을 할당할 수 있습니다.

3. 설치 완료 및 다음 단계

이제 우분투 서버에 Coolify 설치가 성공적으로 완료되었습니다! 방화벽 설정 시 Coolify 대시보드 포트인 8000번을 열어주었으므로, 웹 브라우저에서 http://[당신의 서버 IP]:8000으로 접속하여 Coolify 대시보드를 확인할 수 있습니다.

CoolifyPaaSUbuntuDocker셀프 호스팅배포 자동화서버 구축