배포 개요

이 페이지는 Chorus를 실행하고 셀프 호스팅하는 지원되는 방법들을 소개하고, 각 방법에 필요한 것을 나열하며, 하나를 고르도록 돕습니다. 고르고 나면 Docker, 프로덕션 배포, 운영 가이드가 나머지 길을 안내합니다.

배포 형태

Chorus는 같은 애플리케이션을 두 가지 형태로 실행합니다. 차이는 데이터가 어디에 있는지, 몇 명이 사용하는지에 있습니다.

로컬 단일 머신

단일 사용자를 위한, 한 대의 머신 위의 한 프로세스입니다. Chorus는 내장 PostgreSQL 데이터베이스(PGlite)를 함께 제공하므로 따로 설치할 외부 구성 요소가 없습니다. 명령이 스스로 데이터베이스를 만들고, 마이그레이션을 적용하며, 웹 애플리케이션을 8637 포트에서 제공합니다. 이것은 Chorus를 가장 빠르게 시험해 보는 방법이며, 개인적인 로컬 사용에 알맞은 선택입니다.

이것은 시작하기 가이드가 처음부터 끝까지 안내하는 경로입니다. 글로벌 패키지를 설치하고, 관리자 계정을 설정하고, 로그인합니다. 그 가이드는 로컬 단일 사용자 형태의 표준 설치 안내이므로, 이 페이지에서는 그 단계를 되풀이하지 않습니다.

프로덕션

팀을 위한 공유 설치로, 당신이 직접 관리하고 백업하는 외부 PostgreSQL 16 데이터베이스가 뒷받침하며, 하나 이상의 애플리케이션 인스턴스가 서비스합니다. Redis 7은 단일 인스턴스에서는 선택 사항이지만, 두 개 이상을 실행할 때는 필수입니다. 인스턴스들이 Redis를 통해 서로 실시간 업데이트(Server-Sent Events)를 전파하기 때문입니다. Redis가 없으면 Chorus는 메모리 내 이벤트 방식으로 폴백하는데, 이는 단일 인스턴스에서만 동작합니다.

프로덕션 형태는 컨테이너로 실행하거나(Docker로 배포 참고), 글로벌 npm 패키지에서 당신의 PostgreSQL과 Redis에 연결해 실행하거나, 함께 제공되는 AWS CDK 스택 위에서 실행할 수 있습니다(프로덕션 배포 참고).

전제 조건

• Node.js 22 이상: Chorus는 Node.js 22 런타임을 대상으로 합니다(Docker 이미지는 node:22-alpine 위에 빌드됩니다).
• 8637 포트: 애플리케이션은 여기서 수신 대기합니다. UI와 MCP 엔드포인트에 도달하려면 이 포트를 공개하거나 리버스 프록시하세요.
• 데이터베이스: 로컬 형태에서는 준비할 것이 없습니다(내장 PGlite). 프로덕션에서는 연결 문자열로 도달할 수 있는 외부 PostgreSQL 16 데이터베이스가 필요합니다.
• 캐시: 단일 인스턴스에서는 필요 없습니다. 다중 인스턴스 프로덕션 배포에서는 인스턴스 간 이벤트 전파를 위한 Redis 7 엔드포인트가 필요합니다.

선택하는 방법

하고 싶은 것	선택	데이터베이스	캐시
Chorus를 시험하거나 한 대의 머신에서 혼자 작업하기	로컬 단일 머신	내장 PGlite	없음
가장 적은 구성 요소로 공유 인스턴스 실행하기	스탠드얼론 컨테이너	내장 PGlite(볼륨에 저장)	없음
공유·견고·다중 인스턴스 설치 실행하기	프로덕션(Docker, npm 또는 AWS CDK)	외부 PostgreSQL 16	Redis 7(2개 이상 인스턴스에서 필수)

계속 읽기

• Docker로 배포: 공개된 chorusaidlc/chorus-app 이미지. 스탠드얼론과 프로덕션 Compose 파일, docker run 예시, 전체 환경 변수 참고, 그리고 시작 시 동작.
• 프로덕션 배포: 당신의 PostgreSQL과 Redis에 연결해 실행하기, 다중 인스턴스 요구 사항, 그리고 전체 AWS CDK 안내.
• 운영: 첫 로그인 부트스트랩, 배포 측 인증, 자동 마이그레이션, 그리고 업그레이드 전 백업.