> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 구성

애플리케이션 구성을 명시적으로 유지하고 프로바이더 자격 증명을 서버 측에 두세요.

## 구성을 한 번 변경하고 확인하세요.

실행 중인 웹 앱으로 시작하세요. 편집기에서 apps/web/.env.local를 엽니다. 존재하지 않는 경우 웹 튜토리얼을 사용하여 .env.example을 복사하십시오. 무해한 첫 번째 확인을 위해 EMAIL_PROVIDER=local를 찾아서 로컬에 두십시오. 이 설정은 실제 받은 편지함 대신 로컬 미리 보기로 제품 이메일을 보냅니다. KEY=value 라인을 터미널에 붙여넣지 마십시오.

활성화한 각 서비스에 대해 해당 공급자의 설정 가이드에 따라 명명된 값만 바꾸고 파일을 저장한 후 Ctrl + C를 사용하여 웹 서버를 중지하고 아래 명령을 사용하여 다시 시작하세요. 유효성 검사에서 누락된 키의 이름이 지정되면 이 파일을 다시 열고 해당 키를 공급자 가이드와 비교하세요. 데이터베이스 마이그레이션에 사용되는 값에 대해서만 루트 .env를 동기화된 상태로 유지하세요. 단독으로 복사하면 Next.js가 구성되지 않습니다.

[구성 키 조회](https://supastack.dev/ko/docs/web/project-structure.md)

[명령어 실행 및 파일 편집 방법 알아보기](https://supastack.dev/ko/docs/web/terminal-basics.md)

```
corepack pnpm --filter @supastack/web dev
```


## 실제로 먼저 편집하게 될 설정

저장소 루트의 `.env.example`은 킷이 이해하는 설정의 전체 목록입니다. 그 파일에 없는 이름은 존재하지 않습니다. 처음에는 몇 개만 건드립니다 — 나머지는 공급자 가이드가 요청할 때까지 기본값에 머뭅니다.

각 앱이 읽는 파일: 루트 `.env`는 마이그레이션 명령에 공급하고, `apps/web/.env.local`은 Next.js 서버에, `apps/mobile/.env.local`은 Expo에 공급합니다. 한 파일을 편집해도 다른 파일은 구성되지 않으므로 `DATABASE_URL`은 루트 `.env`와 `apps/web/.env.local` 양쪽에 있습니다.

- `APP_URL` — 앱이 위치한 주소. 로컬에서는 `http://localhost:3000`, 프로덕션에서는 내 도메인입니다.
- `DATABASE_URL` — 마이그레이션과 서버가 공유하는 Postgres 연결 문자열입니다.
- `AUTH_SECRET`과 `CREDENTIAL_ENCRYPTION_KEY` — 생성되는 시크릿입니다. `node scripts/setup-env.mjs`가 대신 채웁니다(이 도우미는 웹 저장소와 All Platforms 모노레포에 함께 제공됩니다).
- 공급자 선택자 — `EMAIL_PROVIDER`, `AI_PROVIDER`, `BILLING_PROVIDER`, `JOB_PROVIDER`, `CAPTCHA_PROVIDER` — 각각 어떤 어댑터가 실행될지 고릅니다. `local`/`fake`/`off` 기본값은 계정이 필요 없습니다.
- `RESEND_API_KEY`나 `STRIPE_SECRET_KEY` 같은 공급자 시크릿 — 맞는 공급자 가이드가 알려줄 때만 추가하세요.


## 환경 예제부터 시작

루트 .env.example이 구성 목록입니다. 공유 검증은 packages/config에 있습니다. 선택한 앱 환경과 프로바이더 모드를 함께 검토하세요. 로컬 인터페이스는 프로덕션 자격 증명 전략이 아닙니다.

자격 증명 없는 참조 모드는 local/test 앱 설정과 fake/로컬 프로바이더를 요구합니다. 프로덕션 프로바이더를 선택하면 런타임 요구 사항이 바뀝니다.


## 시크릿을 API 뒤에 유지

인증 시크릿, 데이터베이스 자격 증명, 프로바이더 키, Stripe 시크릿, Trigger 자격 증명은 서버 전용입니다. NEXT_PUBLIC_ 또는 EXPO_PUBLIC_ 접두사를 붙이지 마세요. 설치 중에 표시하거나 오류 응답에 포함하지 마세요.

브라우저는 공개 구성과 허용된 모델 별칭을 받습니다. 워크스페이스 소유권, 권한 결정, 예산, 프로바이더 선택은 서버에서 강제된 상태로 유지됩니다.


## 사용하기 전에 변경 사항 검증

기존 config 패키지를 통해 구성을 검증하고 관련 결정적 테스트를 실행하세요. 실제 통합을 검증할 준비가 되면 별도의 옵트인 프로바이더 스모크 경로를 사용하세요.

```
corepack pnpm test
corepack pnpm check
corepack pnpm build
```


설정을 계속하려면 [데이터베이스 설정](https://supastack.dev/ko/docs/web/setup-database.md) 가이드를 읽어보세요.


## 다음

[첫 기능 만들기](https://supastack.dev/ko/docs/web/first-feature.md)