# macOS 바이너리

**URL:** https://heroiclabs.com/docs/kr/nakama/getting-started/install/macos/
**Summary:** macOS에서 Nakama 바이너리 및 전제조건들을 설정하고 실행하는 방법. 바이너리 설정을 통해 Docker 없이 Nakama를 설치하고 관리할 수 있습니다.

---


# macOS에 Nakama 바이너리 설치하기

이번 튜토리얼은 macOS에서 Nakama 바이너리와 필수 요건을 설정하고 실행하는 방법에 대해서 설명합니다.

바이너리 설정을 통해 [Docker](../docker/) 없이도 Nakama를 설치하고 관리할 수 있지만, 설정과 관리에 추가적인 단계가 필요합니다:

- CockroachDB 또는 PostgreSQL 설치하기
- 데이터베이스 마이그레이션 수동으로 적용하기
- Nakama와 데이터베이스를 새 버전으로 수동 업그레이드
- 서비스 구성 또는 Nakama와 데이터베이스 수동으로 시작하기

## 필수 조건

### 운영 체제

진행하기 전에 X86_64(64비트) 프로세서 아키텍처가 포함된 macOS 10.9(Mavericks) 이상인지 확인합니다

다음으로, 지원되는 데이터베이스 엔진을 설치합니다.

### CockroachDB

Nakama는 저장소 엔진에 최적화된 쿼리를 포함하는 CockroachDB v20.0 이상을 공식적으로 지원합니다.

[공식적으로 지원되는 메서드](https://www.cockroachlabs.com/docs/stable/install-cockroachdb.html)를 통해 CockroachDB를 설치합니다:

- Homebrew
- 바이너리
- 소스에서 빌드

### PostgreSQL

Nakama는 개발 환경을 위해서 PostgreSQL 9.6 이상을 비공식적으로 지원합니다.

다음을 통해서 PostgreSQL을 설치합니다:

- [공식 PostgreSQL macOS 패키지](https://www.postgresql.org/download/macosx/)
- [Postgres.app](https://postgresapp.com/)
- [Homebrew](https://wiki.postgresql.org/wiki/Homebrew)

## Nakama 다운로드

MacOS용 Nakama 서버 최신 바이너리 얻기:

1. Nakama GitHub 리포지토리 [출시 페이지](https://github.com/heroiclabs/nakama/releases)에서 다운로드합니다.
2. 아카이브를 추출하고 이름을 지정한 후에 적절한 위치로 폴더를 이동합니다.

## Nakama 실행

Nakama 서버를 시작하기 전에 다음을 실행해야 합니다:

1. 선택한 데이터베이스, CockroachDB 또는 PostgreSQL을 실행합니다.
2. Nakama를 처음 실행하거나 버전을 업그레이드한 경우, Nakama 데이터베이스 마이그레이션을 실행합니다.

### Nakama 마이그레이션

Nakama를 처음 실행하거나 버전을 업그레이드한 경우, Nakama 데이터베이스 마이그레이션을 실행해야 할 수도 있습니다. 확실하지 않으면 마이그레이션을 다시 실행하는 것이 안전합니다.

기본 구성으로 CockroachDB를 실행하는 경우, 마이그레이션을 추가 옵션 없이 간단하게 실행할 수 있습니다.

PosgreSQL을 사용하는 경우, 데이터베이스 서버 주소, 사용자, 비밀번호를 입력해야 합니다.

Nakama 마이그레이션을 실행하려면 Nakama 디렉터리로 이동해서 다음을 실행합니다:

**CockroachDB**

```sh
./nakama migrate up
```

**PostgreSQL**

```sh
./nakama migrate up --database.address postgres:password@127.0.0.1:5432
```

### Nakama 서버

CockroachDB 또는 PostgreSQL을 통해 Nakama 서버를 시작하려면 Nakama 디렉터리로 이동하여 다음을 실행합니다:

**CockroachDB**

```sh
./nakama
```

**PostgreSQL**

```sh
./nakama --database.address postgres:password@127.0.0.1:5432
```

[Nakama PostgreSQL 데이터베이스 마이그레이션](#nakama-migrations)을 실행할 때 사용했던 동일한 `database.address` 값을 입력해야 합니다.

## Nakama Console

브라우저에서 `127.0.0.1:7351`로 이동하여 Nakama Console에 액세스할 수 있습니다:

로그인 알림이 표시되면 기본 자격 증명은 `admin:password`입니다. 구성 파일 또는 명령 라인 플래그를 통해 변경할 수 있습니다.

## 구성 파일

Nakama 서버를 사용자 지정으로 설정하기 위해서 여러 [구성 옵션](../../configuration/)을 사용할 수 있습니다.

## 다음 단계

Nakama 서버가 원하는 구성으로 실행중인 경우, 원하는 클라이언트 SDK로 시작할 수 있습니다.