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

## 배포 형태

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

### 로컬 단일 머신

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

이것은 [시작하기 가이드](/ko/guides/getting-started/)가 처음부터 끝까지 안내하는 경로입니다. 글로벌 패키지를 설치하고, 관리자 계정을 설정하고, 로그인합니다. 이 페이지에서는 그 단계를 되풀이하지 않습니다.

로컬 형태는 Docker의 **스탠드얼론 컨테이너**로도 실행할 수 있습니다. 같은 내장 데이터베이스를 쓰며, 데이터는 Docker 볼륨에 보관됩니다. [스탠드얼론(내장 데이터베이스)](/ko/guides/deploy-docker/#스탠드얼론내장-데이터베이스)를 참고하세요.

### 프로덕션

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

프로덕션 형태는 컨테이너로 실행하거나([Docker로 배포](/ko/guides/deploy-docker/) 참고), 글로벌 npm 패키지에서 자체 PostgreSQL과 Redis에 연결해 실행하거나, 함께 제공되는 AWS CDK 스택 위에서 실행할 수 있습니다([프로덕션 배포](/ko/guides/deploy-production/) 참고).

## 전제 조건

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

## 선택하는 방법

<div class="table-scroll" role="region" aria-label="배포 형태 선택하는 방법" tabindex="0">

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

</div>

## 계속 읽기

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