> ## Documentation Index
> Fetch the complete documentation index at: https://docs.casebender.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 빠른 시작 가이드

> CaseBender를 로컬에서 몇 분 안에 배포하기

<Tip>
  **더 쉬운 방법을 찾고 계신가요?** [데스크톱 설치 프로그램](/ko/deployment/desktop-installer)을 사용하여 원클릭 배포와 자동 구성을 경험하세요. 명령줄 필요 없음!
</Tip>

## 사전 요구 사항

시작하기 전에 시스템에 다음이 설치되어 있는지 확인하세요:

* Docker Engine (20.10.0 이상)
* Docker Compose (v2.0.0 이상)
* OpenSSL (SSL 인증서 생성용)

### Docker 설치

#### macOS용:

1. [Docker Hub](https://hub.docker.com/editions/community/docker-ce-desktop-mac)에서 Docker Desktop을 다운로드하고 설치
2. 설치 마법사를 따르세요
3. 설치 확인:

```bash theme={null}
docker --version
docker-compose --version
```

#### Linux (Ubuntu/Debian)용:

```bash theme={null}
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin
```

설치 확인:

```bash theme={null}
docker --version
docker-compose --version
```

#### Windows용:

1. [Docker Hub](https://hub.docker.com/editions/community/docker-ce-desktop-windows)에서 Docker Desktop을 다운로드하고 설치
2. 설치 마법사를 따르세요
3. 설치 확인:

```bash theme={null}
docker --version
docker-compose --version
```

## 로컬 배포

### 1단계: 저장소 복제

```bash theme={null}
git clone https://github.com/casebender/casebender.git
cd casebender
```

### 2단계: 환경 설정

루트 디렉토리에 `.env` 파일 생성:

```bash theme={null}
cp .env.example .env
```

`.env` 파일을 편집하여 환경 변수 구성:

```
DB_HOST=postgres
DB_PORT=5432
DB_NAME=casebender
DB_USER=postgres
DB_PASSWORD=your_secure_password

REDIS_HOST=redis
REDIS_PORT=6379

JWT_SECRET=your_jwt_secret_key
```

### 3단계: 서비스 시작

```bash theme={null}
docker-compose up -d
```

이 명령은 필요한 모든 서비스를 시작합니다:

* API 백엔드 (Node.js)
* 프론트엔드 (React)
* 데이터베이스 (PostgreSQL)
* Redis (캐시 및 큐용)

### 4단계: 배포 확인

모든 컨테이너가 실행 중인지 확인:

```bash theme={null}
docker-compose ps
```

모든 서비스가 "Up" 상태인지 확인하세요.

### 5단계: 애플리케이션 접근

* **사용자 인터페이스**: [http://localhost:3000](http://localhost:3000)
* **API**: [http://localhost:8000](http://localhost:8000)
* **API 문서**: [http://localhost:8000/api-docs](http://localhost:8000/api-docs)

### 기본 로그인 자격 증명

CaseBender를 배포한 후, 다음 기본 자격 증명으로 로그인할 수 있습니다:

```
사용자 이름: admin@casebender.app
비밀번호: secret1234
```

<Warning>
  보안상의 이유로, 첫 로그인 후 즉시 이러한 기본 자격 증명을 변경하는 것을 강력히 권장합니다.
</Warning>

## 초기 설정

### 관리자 계정 생성

```bash theme={null}
docker-compose exec api npm run create-admin
```

관리자 계정을 생성하기 위한 지침을 따르세요.

### 샘플 데이터 가져오기 (선택 사항)

```bash theme={null}
docker-compose exec api npm run import-sample-data
```

## 문제 해결

### 로그 확인

문제가 발생하면 컨테이너 로그를 확인하세요:

```bash theme={null}
docker-compose logs -f api
docker-compose logs -f frontend
docker-compose logs -f postgres
```

### 일반적인 문제

#### 데이터베이스 연결 오류

`.env` 파일의 데이터베이스 자격 증명이 올바른지, PostgreSQL 컨테이너가 실행 중인지 확인하세요:

```bash theme={null}
docker-compose ps postgres
```

#### 권한 문제

Docker 볼륨에 접근할 때 권한 문제가 발생하는 경우:

```bash theme={null}
sudo chown -R $(whoami):$(whoami) ./data
```

## 다음 단계

이제 CaseBender가 로컬에서 실행 중이므로 다음을 수행할 수 있습니다:

1. [통합 구성](/ko/settings/integrations/introduction)
2. [워크플로우 사용자 지정](/ko/settings/workflows/introduction)
3. [알림 관리 탐색](/ko/alerts/list-view)
4. [케이스 관리 학습](/ko/cases/introduction)