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

# 배포

> 앱을 프로덕션 및 로컬 기기에 배포합니다.

# 배포

Kazzle 앱은 Kazzle 호스팅에 배포하거나 기기 컴퓨터에 설치할 수 있습니다.

## 원격 배포

배포는 비동기식입니다. 앱 페이지, AI, 또는 체크아웃에서 `kazzle deploy`를 실행하면 서버 측 배포 작업이 대기열에 추가됩니다. `kazzle deploy`는 체크아웃을 업로드하고, 배포 실행기가 빌드하여 배포합니다.

각 컴포넌트별로:

1. **UI 컴포넌트**는 설정된 경우 `runtime.prod.build`를 실행하는 Docker 이미지로 빌드되고, 그렇지 않으면 `bun run build`를 실행합니다
2. **프로세스 컴포넌트**는 `kazzle.config.ts`의 `runtime.prod.command` 명령을 실행합니다 - 누락되면 배포가 실패합니다
3. 각 컴포넌트는 자체 이미지와 배포를 받습니다
4. 프로덕션 URL이 할당됩니다

앱 페이지에서 또는 AI를 통해 배포를 트리거합니다:

```
Deploy my app
```

## 프로덕션 URL

배포된 앱은 `https://kazzle-{appId}.kazzle.app` 같은 URL을 받습니다. 여러 프로세스 컴포넌트가 있는 앱은 컴포넌트당 하나의 URL을 받습니다. 공개 앱은 URL을 가진 누구나 접근할 수 있습니다. 비공개 앱은 Kazzle 인증이 필요합니다.

## 프로덕션의 런타임 명령

| 단계                     | 명령                                  | 시기                  |
| ---------------------- | ----------------------------------- | ------------------- |
| `runtime.prod.build`   | 프로덕션 빌드 명령, 또는 생략 시 `bun run build` | UI 컴포넌트 배포 중        |
| `runtime.prod.command` | `kazzle.config.ts`의 프로덕션 시작 명령      | 프로덕션에서 프로세스 컴포넌트 시작 |

프로덕션 명령은 기본 명령이어야 합니다(예: `bun server/index.ts`) - 배포된 런타임은 `PORT`, `HOST`, 및 시크릿을 직접 주입합니다. 개발/프로덕션 분할에 대해서는 [Kazzle CLI](/apps/cli) 페이지를 참조하세요.

## 로컬 설치

앱은 Kazzle 데몬을 통해 기기 컴퓨터(로컬 머신)에서도 실행할 수 있습니다. `runtime.dev.command` 명령은 개발 모드에서 앱을 시작합니다.