# 빠른 시작

> 명령 두 개로 셀프 호스팅 Nodaro Community Edition을 시작하고, /setup 페이지에서 상태를 확인한 다음 공급자 키나 Nodaro Cloud 연결을 추가해 생성을 시작하세요.

Source: https://nodaro.ai/ko/docs/self-hosting/quickstart

**Community Edition 빠른 시작**을 따르면 명령 두 개로 아무것도 없는 상태에서 실행 중인 셀프 호스팅 Nodaro까지 갈 수 있습니다. Docker Compose 스택에 자체 데이터베이스, 로그인, 스토리지, 큐가 들어 있으므로 만들 클라우드 계정도, 찾아야 할 API 키도, 구성할 것도 없습니다. Docker 24 이상과 Docker Compose v2가 필요합니다.

## Nodaro 시작
### 저장소 복제와 스택 시작
```bash
git clone https://github.com/nodaroai/app.nodaro.ai.git nodaro
cd nodaro
docker compose -f docker-compose.community.yml up
```

첫 부팅에서는 미리 빌드된 약 2.4GB의 앱 이미지와 번들된 서비스를 내려받습니다. 컴파일이 아니라 다운로드이므로 CPU에 부담을 주지 않습니다. 이후 부팅은 몇 초면 끝납니다.

### 앱 열기와 계정 만들기
`http://localhost:3000`을 열고 아무 이메일 주소와 비밀번호로 가입하세요. 로컬 스택은 확인 이메일을 보내지 않으므로 계정을 바로 쓸 수 있습니다.

처음 방문하면 홈 화면에 **Welcome Demo** 워크플로가 추가됩니다. 대본, 이미지, 동영상, 보이스, 최종 편집까지 모든 결과가 이미 만들어진 완성된 실행입니다. 아무것도 구성하기 전에 노드를 열어 보고 최종 클립을 재생할 수 있습니다.

### /setup에서 설치 확인
`http://localhost:3000/setup`을 여세요. 이 페이지는 데이터베이스, Redis, 스토리지, 암호화 키, 공급자 키의 실시간 상태를 보여 주며, 로그인이 필요 없습니다. 새로 만든 스택에서는 공급자 키를 제외한 모든 카드가 초록색입니다.

### 모델 공급자 추가
아래 세 가지 방법 중 하나를 고르세요. 공급자가 생기면 데모의 **장면 이미지** 노드에서 **실행**을 클릭하세요. 가장 저렴한 이미지 모델인 [Z-Image](https://nodaro.ai/docs/models/image/z-image)를 사용하며, 몇 초 만에 결과를 반환합니다.

## 시작되는 서비스
| 서비스 | 역할 | 데이터 저장 위치 |
| --- | --- | --- |
| **Postgres**(Supabase 이미지) | 데이터베이스입니다. 첫 부팅 때 마이그레이션이 자동으로 적용됩니다. | `db-data` 볼륨 |
| **GoTrue** | 이메일과 비밀번호 로그인입니다. 이메일 서버가 필요 없습니다. | — |
| **PostgREST** | 편집기가 통신하는 데이터 API입니다. | — |
| **MinIO** | 미디어 스토리지입니다. 생성된 이미지, 동영상, 오디오가 내 디스크에 남습니다. | `minio-data` 볼륨 |
| **Redis** | 작업 큐입니다. | `redis-data` 볼륨 |
| **Nodaro** | 앱입니다. 편집기, API, 워커가 포트 `3000`에서 실행됩니다. | `app-data` 볼륨 |

스택은 내 컴퓨터에 포트 두 개를 공개합니다. 앱용 `3000`과 MinIO 콘솔용 `9001`이며, `9001`은 루프백 인터페이스에만 바인딩됩니다.

## 모델 공급자 추가
데모 보기는 무료이고 오프라인에서도 작동합니다. 노드를 직접 실행하려면 설치에 모델 공급자가 필요합니다. 공급자가 생기기 전까지 홈 화면에 각 방법의 버튼이 있는 **이 설치 환경에서는 아직 생성할 수 없습니다.** 알림이 표시되며, 이 알림은 닫을 수 있습니다.

세 가지 방법은 함께 쓸 수 있으며, 규칙은 하나입니다. 설치가 Nodaro Cloud에 연결되어 있으면서 `NODARO_API_KEY`도 가지고 있으면, 연결을 쓰고 키는 무시합니다.

**키 붙여 넣기**

파일도 재시작도 필요 없습니다.

1. `/setup`을 열고 1단계 **서버 로그인 계정 만들기**를 완료하세요. 상태 카드는 로그인 없이 볼 수 있지만, 키를 저장하려면 로그인해야 합니다.
2. **설치 상태** 섹션에서 공급자 타일을 찾으세요. 같은 타일이 앱의 **연동 › 모델 공급자**에도 있습니다.
3. 타일에서 **키 붙여 넣기**를 클릭하고, 키를 붙여 넣은 다음 저장하세요.

각 타일에는 그 키로 실행되는 기능과 키를 받는 곳이 나와 있습니다. 키는 내 데이터베이스에 암호화되어 저장되고 즉시 적용됩니다. Nodaro Cloud에 연결하면 타일을 채울 필요가 없습니다. 연결이 모든 타일을 대신합니다.

**Nodaro Cloud 연결**

관리할 키가 없습니다.

1. `/setup`의 2단계 **모델 공급자 연결**에서 **nodaro.ai 연결**을 클릭하세요.
2. 브라우저에서 Nodaro Cloud 동의 화면이 열립니다. 로그인하거나, 1,500크레딧이 포함된 무료 계정을 만든 다음 승인하세요.
3. 연결된 상태로 내 설치에 돌아옵니다.

그러면 이미지, 동영상, 음성, 텍스트 모델이 내 Nodaro Cloud 계정을 통해 실행되고 크레딧으로 청구됩니다. 자세한 내용은 [Nodaro Cloud에 연결](https://nodaro.ai/docs/self-hosting/cloud-connect)을 읽어 보세요.

**.env에 설정**

코드형 인프라에 적합합니다. Compose 파일 옆에 `.env`라는 파일을 만드세요.

```bash
KIE_API_KEY=...            # broadest model coverage
# or
REPLICATE_API_TOKEN=...
# or
NODARO_API_KEY=...         # a personal API token from app.nodaro.ai, Settings › API Tokens
```

그런 다음 적용하세요.

```bash
docker compose -f docker-compose.community.yml up -d
```

`.env`의 키는 화면에 붙여 넣은 키보다 우선합니다. 그 타일에는 `set (env)`(환경 변수에서 설정됨)이 표시되며, 그 자리에서 편집할 수 없습니다.

모든 공급자와 각 공급자로 실행되는 기능은 [공급자 키](https://nodaro.ai/docs/self-hosting/provider-keys)에서 확인하세요.

비용은 공급자에게 직접 냅니다. Community Edition에는 크레딧 시스템도, Nodaro 수수료도, 워터마크도 없습니다.

## 무료로 편집기 배우기
홈 화면의 **튜토리얼**은 첫 부팅 때 추가되는 단계별 안내 모음으로 시작합니다. 둘러보는 데 비용이 들지 않습니다. 이미지, 동영상, 오디오는 Nodaro의 CDN에서 불러오므로 인터넷 연결이 필요합니다. [튜토리얼과 템플릿](https://nodaro.ai/docs/get-started/tutorials-and-templates)을 참조하세요.

## 명령줄에서 설치 확인
`/setup`보다 더 깊이 확인하려면 복제한 저장소에서 계약 프로브를 실행하세요. Node.js가 필요합니다.

```bash
node tools/community-smoke.mjs http://localhost:3000
```

프로브는 일회용 계정으로 가입하고, 워크플로를 만들고, 생성을 제출하고, 작업이 끝날 때까지 따라간 다음 통과한 검사를 보고합니다. 이미 공급자 키를 추가한 경우처럼 내 설치에 해당하지 않는 검사는 건너뜀으로 보고됩니다. 추가 플래그가 없으면 프로브는 비용을 전혀 쓰지 않습니다.

실제 생성도 테스트하려면 `--keyed`를 추가하세요.

```bash
node tools/community-smoke.mjs http://localhost:3000 --keyed
```

`--keyed`를 쓰려면 설치에 `KIE_API_KEY` 또는 `REPLICATE_API_TOKEN`이 `.env`에 있거나 `/setup`에 붙여 넣어져 있어야 합니다. 그 키에 맞는 가장 저렴한 모델로 생성을 한 번 실행합니다. `KIE_API_KEY`로는 [Z-Image](https://nodaro.ai/docs/models/image/z-image)를, `REPLICATE_API_TOKEN`으로는 [Flux 2 Klein](https://nodaro.ai/docs/models/image/flux-2-klein-open)을 씁니다. 공급자 요금으로는 보통 1센트도 들지 않습니다. 그런 다음 프로브는 미디어가 내 설치의 스토리지에 저장되었는지 확인합니다. Nodaro Cloud 연결이나 토큰은 따로 확인합니다.

## 자주 쓰는 명령
| 작업 | 명령 |
| --- | --- |
| 백그라운드에서 시작 | `docker compose -f docker-compose.community.yml up -d` |
| 로그 따라 보기 | `docker compose -f docker-compose.community.yml logs -f` |
| 스택 중지 | `docker compose -f docker-compose.community.yml down` |
| 바뀐 `.env` 적용 | `docker compose -f docker-compose.community.yml up -d` |

정말 의도한 경우가 아니라면 `down`에 `-v`를 붙이지 마세요. `docker compose down -v`는 볼륨을 삭제하며, 그와 함께 데이터베이스와 미디어도 삭제됩니다.

**다른 사람이 설치에 접근하기 전에:** 
Compose 기본값은 로컬 사용을 위한 것이며, 공개되어 있습니다. 스택을 네트워크에 공개하기 전에 새 인증 키를 발급하고, 데이터베이스와 스토리지의 비밀번호를 새로 설정하고, 설치를 HTTPS로 제공하세요. [설치 보안 강화](https://nodaro.ai/docs/self-hosting/install#harden-the-install-before-you-expose-it)와 [리버스 프록시와 HTTPS](https://nodaro.ai/docs/self-hosting/reverse-proxy)를 따르세요.

## 다음 단계
- [설치](https://nodaro.ai/docs/self-hosting/install): 관리형 서비스, 스토리지, 시크릿을 포함한 전체 설정.
- [리버스 프록시와 HTTPS](https://nodaro.ai/docs/self-hosting/reverse-proxy): 내 도메인에서 설치 제공.
- [업데이트](https://nodaro.ai/docs/self-hosting/updating): 이미지 태그와 업데이트.
- [백업과 복원](https://nodaro.ai/docs/self-hosting/backups): 각각 명령 하나.
- [문제 해결](https://nodaro.ai/docs/self-hosting/troubleshooting): `/setup`의 카드가 빨간색일 때.

## 자주 묻는 질문

### 셀프 호스팅 Nodaro를 처음 시작하는 데 얼마나 걸리나요?

첫 부팅에서 미리 빌드된 약 2.4GB의 앱 이미지와 번들된 서비스를 내려받으므로, 일반적인 인터넷 연결로 몇 분이 걸립니다. 컴파일이 아니라 다운로드입니다. 이후 부팅은 몇 초면 끝납니다.

### Community Edition을 실행하려면 .env 파일이 필요한가요?

아니요. docker-compose.community.yml의 모든 값에는 작동하는 기본값이 있습니다. .env 파일은 공급자 키를 추가하거나, 공개 URL을 바꾸거나, 내 관리형 서비스를 쓸 때만 만드세요.

### 새로 설치한 Nodaro에서 아무것도 생성할 수 없는 이유는 무엇인가요?

아직 모델 공급자가 없기 때문입니다. /setup에 공급자 키를 붙여 넣거나, .env에 키를 설정하거나, 설치를 Nodaro Cloud 계정에 연결하세요. 공급자가 생길 때까지 홈 화면에 두 가지 방법을 안내하는 알림이 표시됩니다.

### 기본 설치를 그대로 인터넷에 공개해도 안전한가요?

아니요. Compose 파일의 기본 키와 비밀번호는 공개되어 있습니다. 다른 사람이 설치에 접근할 수 있게 하기 전에 새 인증 키를 발급하고, 새 비밀번호를 설정하고, 리버스 프록시 뒤에서 HTTPS로 제공하세요.

### Community Edition의 비용은 얼마인가요?

Nodaro에 내는 비용은 없습니다. 크레딧 시스템도, Nodaro 수수료도, 워터마크도 없습니다. 모델 공급자에게 직접 비용을 내거나, Nodaro Cloud 연결로 실행되는 작업에 크레딧으로 비용을 냅니다.