Ubuntu 서버에 Coolify V4 설치하고 Docker 배포 관리하기

VPS 한 대에 작은 서비스를 여럿 올리기 시작하면 Docker Compose 파일, 도메인, 배포 순서가 흩어집니다. Coolify는 SSH 연결 가능한 서버에서 애플리케이션과 데이터베이스를 관리하는 셀프호스팅 배포 도구입니다.

Ubuntu 서버에 Coolify V4를 설치한 뒤 Git 저장소와 Docker 서비스를 한 화면에서 관리하려는 경우에 맞는 경로만 적습니다. 직접 돌려보지는 않았습니다. Coolify 공식 README와 설치 문서를 기준으로 정리했습니다. 저라면 개인 서버에서 여러 프로젝트의 배포 화면을 한곳에 모아야 할 때 검토하겠습니다.

개요

Coolify는 Heroku, Netlify, Vercel과 비슷한 배포 흐름을 내 서버에서 운영하는 오픈소스 도구입니다. VPS, 베어메탈, Raspberry Pi처럼 SSH로 접속할 수 있는 장비를 서버로 등록하고, 애플리케이션·서비스·데이터베이스를 관리합니다.

컨테이너를 직접 다루는 흐름은 그대로 남습니다. 다만 저장소 연결, 빌드, 도메인, HTTPS 설정을 여러 Compose 프로젝트마다 반복하지 않아도 됩니다. Docker Compose로 n8n을 올리는 기본 흐름은 n8n 셀프 호스팅 설치 글도 같이 보면 연결됩니다.

시스템 아키텍처

Coolify 관리 서버: 배포 설정과 서버 연결 정보를 관리합니다.

대상 서버: 컨테이너와 데이터베이스가 실제로 실행되는 장비입니다.

Git 저장소: 배포할 소스와 브랜치를 선택하는 위치입니다.

공식 README는 Coolify 서버와 배포 대상 서버를 나누는 구성을 권장합니다. 운영 서비스와 관리 서버를 한 대에 몰아넣기 전에는 장애 범위를 먼저 판단해야 합니다.

적용 대상

개인 VPS에서 웹 서비스 여러 개를 운영하거나, 팀 내부에서 배포 절차를 통일하려는 경우에 맞습니다. Git 저장소를 연결하고 브랜치 기준으로 배포하려는 흐름에도 어울립니다.

Docker Compose 파일 몇 개만 가끔 실행한다면 관리 화면을 추가할 이유가 적습니다. 서버 한 대에서 명령으로 충분히 관리되는 구성이라면 Compose와 리버스 프록시를 유지하는 편이 낫습니다.

사전 준비 사항

• Ubuntu 등 Linux 서버와 SSH 접속 권한
• Docker가 다른 서비스와 충돌하지 않는 서버
• 외부 공개가 필요할 때 사용할 도메인과 DNS 관리 권한
• 설치 전에 확인할 방화벽·보안 그룹 정책

관리 화면을 공인 IP로 바로 열기 전에는 접근 방법을 정해두는 편이 좋습니다. 운영 도메인과 관리자 접근 경로를 같은 규칙으로 섞지 마세요.

설치 절차

공식 설치 스크립트는 아래 한 줄입니다. 서버에 SSH로 접속한 뒤 실행합니다.

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

설치가 끝나면 스크립트가 출력한 접속 주소로 관리 화면을 엽니다. 첫 화면에서 관리자 계정을 만들고, 서버 등록 단계에 SSH 연결 정보를 넣으시면 됩니다.

애플리케이션은 Git 저장소를 연결한 뒤 브랜치, 빌드 방식, 도메인을 순서대로 설정합니다. 기존 Docker Compose 서비스를 옮길 때는 볼륨 경로와 환경 변수부터 대조해주시면 됩니다.

확인

서버에서 docker ps를 실행합니다. Coolify 관련 컨테이너가 실행 중이고, 설치 스크립트가 출력한 주소에서 초기 관리자 설정 화면이 열리면 설치가 완료된 것입니다.